vrchat_dart_generated 1.20.3

SDKdartflutter
Platformandroidioswindowslinuxmacosweb

The generated API used by vrchat_dart. Generated from https://github.com/vrchatapi/specification.

vrchat_dart_generated (EXPERIMENTAL)

VRChat API Banner

Welcome to the VRChat API

Before we begin, we would like to state this is a COMMUNITY DRIVEN PROJECT. This means that everything you read on here was written by the community itself and is not officially supported by VRChat. The documentation is provided "AS IS", and any action you take towards VRChat is completely your own responsibility.

The documentation and additional libraries SHALL ONLY be used for applications interacting with VRChat's API in accordance with their Terms of Service and Community Guidelines, and MUST NOT be used for modifying the client, "avatar ripping", or other illegal activities. Malicious usage or spamming the API may result in account termination. Certain parts of the API are also more sensitive than others, for example moderation, so please tread extra carefully and read the warnings when present.

Tupper Policy on API

Finally, use of the API using applications other than the approved methods (website, VRChat application, Unity SDK) is not officially supported. VRChat provides no guarantee or support for external applications using the API. Access to API endpoints may break at any time, without notice. Therefore, please do not ping VRChat Staff in the VRChat Discord if you are having API problems, as they do not provide API support. We will make a best effort in keeping this documentation and associated language libraries up to date, but things might be outdated or missing. If you find that something is no longer valid, please contact us on Discord or create an issue and tell us so we can fix it.

Getting Started

The VRChat API can be used to programmatically retrieve or update information regarding your profile, friends, avatars, worlds and more. The API consists of two parts, "Photon" which is only used in-game, and the "Web API" which is used by both the game and the website. This documentation focuses only on the Web API.

The API is designed around the REST ideology, providing semi-simple and usually predictable URIs to access and modify objects. Requests support standard HTTP methods like GET, PUT, POST, and DELETE and standard status codes. Response bodies are always UTF-8 encoded JSON objects, unless explicitly documented otherwise.

🛑 Warning! Do not touch Photon!
Photon is only used by the in-game client and should not be touched. Doing so may result in permanent account termination.
ℹ️ Authentication
Read Authentication for how to log in.

Using the API

For simply exploring what the API can do it is strongly recommended to download Insomnia, a free and open-source API client that's great for sending requests to the API in an orderly fashion. Insomnia allows you to send data in the format that's required for VRChat's API. It is also possible to try out the API in your browser, by first logging in at vrchat.com/home and then going to vrchat.com/api/1/auth/user, but the information will be much harder to work with.

For more permanent operation such as software development it is instead recommended to use one of the existing language SDKs. This community project maintains API libraries in several languages, which allows you to interact with the API with simple function calls rather than having to implement the HTTP protocol yourself. Most of these libraries are automatically generated from the API specification, sometimes with additional helpful wrapper code to make usage easier. This allows them to be almost automatically updated and expanded upon as soon as a new feature is introduced in the specification itself. The libraries can be found on GitHub or following:

Pagination

Most endpoints enforce pagination, meaning they will only return 10 entries by default, and never more than 100.
Using both the limit and offset parameters allows you to easily paginate through a large number of objects.

Query ParameterTypeDescription
nintegerThe number of objects to return. This value often defaults to 10. Highest limit is always 100.
offsetintegerA zero-based offset from the default object sorting.

If a request returns fewer objects than the limit parameter, there are no more items available to return.

Contribution

Do you want to get involved in the documentation effort? Do you want to help improve one of the language API libraries? This project is an OPEN Open Source Project! This means that individuals making significant and valuable contributions are given commit-access to the project. It also means we are very open and welcoming of new people making contributions, unlike some more guarded open-source projects.

Discord

This Dart package is automatically generated by the OpenAPI Generator project:

  • API version: 1.20.3
  • Generator version: 7.15.0
  • Build package: org.openapitools.codegen.languages.DartDioClientCodegen For more information, please visit https://github.com/VRChatAPI

Requirements

Installation & Usage

pub.dev

To use the package from pub.dev, please include the following in pubspec.yaml

dependencies:
  vrchat_dart_generated: 1.12.0

Github

If this Dart package is published to Github, please include the following in pubspec.yaml

dependencies:
  vrchat_dart_generated:
    git:
      url: https://github.com/GIT_USER_ID/GIT_REPO_ID.git
      #ref: main

Local development

To use the package from your local drive, please include the following in pubspec.yaml

dependencies:
  vrchat_dart_generated:
    path: /path/to/vrchat_dart_generated

Getting Started

Please follow the installation procedure and then run the following:

import 'package:vrchat_dart_generated/vrchat_dart_generated.dart';


final api = VrchatDartGenerated().getAuthenticationApi();

try {
    final response = await api.cancelPending2FA();
    print(response);
} catch on DioException (e) {
    print("Exception when calling AuthenticationApi->cancelPending2FA: $e\n");
}

Documentation for API Endpoints

All URIs are relative to https://api.vrchat.cloud/api/1

ClassMethodHTTP requestDescription
AuthenticationApicancelPending2FADELETE /auth/twofactorauth/totp/pendingCancel pending enabling of time-based 2FA codes
AuthenticationApicheckUserExistsGET /auth/existsCheck User Exists
AuthenticationApiconfirmEmailGET /auth/confirmEmailConfirm Email
AuthenticationApideleteUserPUT /users/{userId}/deleteDelete User
AuthenticationApidisable2FADELETE /auth/twofactorauthDisable 2FA
AuthenticationApienable2FAPOST /auth/twofactorauth/totp/pendingEnable time-based 2FA codes
AuthenticationApigetCurrentUserGET /auth/userLogin and/or Get Current User Info
AuthenticationApigetRecoveryCodesGET /auth/user/twofactorauth/otpGet 2FA Recovery codes
AuthenticationApilogoutPUT /logoutLogout
AuthenticationApiregisterUserAccountPOST /auth/registerRegister User Account
AuthenticationApiresendEmailConfirmationPOST /auth/user/resendEmailResend Email Confirmation
AuthenticationApiverify2FAPOST /auth/twofactorauth/totp/verifyVerify 2FA code
AuthenticationApiverify2FAEmailCodePOST /auth/twofactorauth/emailotp/verifyVerify 2FA email code
AuthenticationApiverifyAuthTokenGET /authVerify Auth Token
AuthenticationApiverifyLoginPlaceGET /auth/verifyLoginPlaceVerify Login Place
AuthenticationApiverifyPending2FAPOST /auth/twofactorauth/totp/pending/verifyVerify Pending 2FA code
AuthenticationApiverifyRecoveryCodePOST /auth/twofactorauth/otp/verifyVerify 2FA code with Recovery code
AvatarsApicreateAvatarPOST /avatarsCreate Avatar
AvatarsApideleteAvatarDELETE /avatars/{avatarId}Delete Avatar
AvatarsApideleteImpostorDELETE /avatars/{avatarId}/impostorDelete generated Impostor
AvatarsApienqueueImpostorPOST /avatars/{avatarId}/impostor/enqueueEnqueue Impostor generation
AvatarsApigetAvatarGET /avatars/{avatarId}Get Avatar
AvatarsApigetAvatarStylesGET /avatarStylesGet Avatar Styles
AvatarsApigetFavoritedAvatarsGET /avatars/favoritesList Favorited Avatars
AvatarsApigetImpostorQueueStatsGET /avatars/impostor/queue/statsGet Impostor Queue Stats
AvatarsApigetLicensedAvatarsGET /avatars/licensedList Licensed Avatars
AvatarsApigetOwnAvatarGET /users/{userId}/avatarGet Own Avatar
AvatarsApisearchAvatarsGET /avatarsSearch Avatars
AvatarsApiselectAvatarPUT /avatars/{avatarId}/selectSelect Avatar
AvatarsApiselectFallbackAvatarPUT /avatars/{avatarId}/selectFallbackSelect Fallback Avatar
AvatarsApiupdateAvatarPUT /avatars/{avatarId}Update Avatar
CalendarApicreateGroupCalendarEventPOST /calendar/{groupId}/eventCreate a calendar event
CalendarApideleteGroupCalendarEventDELETE /calendar/{groupId}/{calendarId}Delete a calendar event
CalendarApifollowGroupCalendarEventPOST /calendar/{groupId}/{calendarId}/followFollow a calendar event
CalendarApigetCalendarEventsGET /calendarList calendar events
CalendarApigetFeaturedCalendarEventsGET /calendar/featuredList featured calendar events
CalendarApigetFollowedCalendarEventsGET /calendar/followingList followed calendar events
CalendarApigetGroupCalendarEventGET /calendar/{groupId}/{calendarId}Get a calendar event
CalendarApigetGroupCalendarEventICSGET /calendar/{groupId}/{calendarId}.icsDownload calendar event as ICS
CalendarApigetGroupCalendarEventsGET /calendar/{groupId}List a group's calendar events
CalendarApiupdateGroupCalendarEventPUT /calendar/{groupId}/{calendarId}/eventUpdate a calendar event
EconomyApigetBalanceGET /user/{userId}/balanceGet Balance
EconomyApigetCurrentSubscriptionsGET /auth/user/subscriptionGet Current Subscriptions
EconomyApigetLicenseGroupGET /licenseGroups/{licenseGroupId}Get License Group
EconomyApigetProductListingGET /listing/{productId}Get Product Listing
EconomyApigetProductListingsGET /user/{userId}/listingsGet User Product Listings
EconomyApigetSteamTransactionGET /Steam/transactions/{transactionId}Get Steam Transaction
EconomyApigetSteamTransactionsGET /Steam/transactionsList Steam Transactions
EconomyApigetSubscriptionsGET /subscriptionsList Subscriptions
EconomyApigetTiliaStatusGET /tilia/statusGet Tilia Status
EconomyApigetTiliaTosGET /user/{userId}/tilia/tosGet Tilia TOS Agreement Status
EconomyApigetTokenBundlesGET /tokenBundlesList Token Bundles
FavoritesApiaddFavoritePOST /favoritesAdd Favorite
FavoritesApiclearFavoriteGroupDELETE /favorite/group/{favoriteGroupType}/{favoriteGroupName}/{userId}Clear Favorite Group
FavoritesApigetFavoriteGroupGET /favorite/group/{favoriteGroupType}/{favoriteGroupName}/{userId}Show Favorite Group
FavoritesApigetFavoriteGroupsGET /favorite/groupsList Favorite Groups
FavoritesApigetFavoriteLimitsGET /auth/user/favoritelimitsGet Favorite Limits
FavoritesApigetFavoritesGET /favoritesList Favorites
FavoritesApiremoveFavoriteDELETE /favorites/{favoriteId}Remove Favorite
FavoritesApiupdateFavoriteGroupPUT /favorite/group/{favoriteGroupType}/{favoriteGroupName}/{userId}Update Favorite Group
FilesApicreateFilePOST /fileCreate File
FilesApicreateFileVersionPOST /file/{fileId}Create File Version
FilesApideleteFileDELETE /file/{fileId}Delete File
FilesApideleteFileVersionDELETE /file/{fileId}/{versionId}Delete File Version
FilesApidownloadFileVersionGET /file/{fileId}/{versionId}Download File Version
FilesApifinishFileDataUploadPUT /file/{fileId}/{versionId}/{fileType}/finishFinish FileData Upload
FilesApigetAdminAssetBundleGET /adminassetbundles/{adminAssetBundleId}Get AdminAssetBundle
FilesApigetFileGET /file/{fileId}Show File
FilesApigetFileAnalysisGET /analysis/{fileId}/{versionId}Get File Version Analysis
FilesApigetFileAnalysisSecurityGET /analysis/{fileId}/{versionId}/securityGet File Version Analysis Security
FilesApigetFileAnalysisStandardGET /analysis/{fileId}/{versionId}/standardGet File Version Analysis Standard
FilesApigetFileDataUploadStatusGET /file/{fileId}/{versionId}/{fileType}/statusCheck FileData Upload Status
FilesApigetFilesGET /filesList Files
FilesApistartFileDataUploadPUT /file/{fileId}/{versionId}/{fileType}/startStart FileData Upload
FilesApiuploadGalleryImagePOST /galleryUpload gallery image
FilesApiuploadIconPOST /iconUpload icon
FilesApiuploadImagePOST /file/imageUpload gallery image, icon, emoji or sticker
FriendsApideleteFriendRequestDELETE /user/{userId}/friendRequestDelete Friend Request
FriendsApifriendPOST /user/{userId}/friendRequestSend Friend Request
FriendsApigetFriendStatusGET /user/{userId}/friendStatusCheck Friend Status
FriendsApigetFriendsGET /auth/user/friendsList Friends
FriendsApiunfriendDELETE /auth/user/friends/{userId}Unfriend
GroupsApiaddGroupGalleryImagePOST /groups/{groupId}/galleries/{groupGalleryId}/imagesAdd Group Gallery Image
GroupsApiaddGroupMemberRolePUT /groups/{groupId}/members/{userId}/roles/{groupRoleId}Add Role to GroupMember
GroupsApiaddGroupPostPOST /groups/{groupId}/postsCreate a post in a Group
GroupsApibanGroupMemberPOST /groups/{groupId}/bansBan Group Member
GroupsApicancelGroupRequestDELETE /groups/{groupId}/requestsCancel Group Join Request
GroupsApicreateGroupPOST /groupsCreate Group
GroupsApicreateGroupAnnouncementPOST /groups/{groupId}/announcementCreate Group Announcement
GroupsApicreateGroupGalleryPOST /groups/{groupId}/galleriesCreate Group Gallery
GroupsApicreateGroupInvitePOST /groups/{groupId}/invitesInvite User to Group
GroupsApicreateGroupRolePOST /groups/{groupId}/rolesCreate GroupRole
GroupsApideleteGroupDELETE /groups/{groupId}Delete Group
GroupsApideleteGroupAnnouncementDELETE /groups/{groupId}/announcementDelete Group Announcement
GroupsApideleteGroupGalleryDELETE /groups/{groupId}/galleries/{groupGalleryId}Delete Group Gallery
GroupsApideleteGroupGalleryImageDELETE /groups/{groupId}/galleries/{groupGalleryId}/images/{groupGalleryImageId}Delete Group Gallery Image
GroupsApideleteGroupInviteDELETE /groups/{groupId}/invites/{userId}Delete User Invite
GroupsApideleteGroupPostDELETE /groups/{groupId}/posts/{notificationId}Delete a Group post
GroupsApideleteGroupRoleDELETE /groups/{groupId}/roles/{groupRoleId}Delete Group Role
GroupsApigetGroupGET /groups/{groupId}Get Group by ID
GroupsApigetGroupAnnouncementsGET /groups/{groupId}/announcementGet Group Announcement
GroupsApigetGroupAuditLogsGET /groups/{groupId}/auditLogsGet Group Audit Logs
GroupsApigetGroupBansGET /groups/{groupId}/bansGet Group Bans
GroupsApigetGroupGalleryImagesGET /groups/{groupId}/galleries/{groupGalleryId}Get Group Gallery Images
GroupsApigetGroupInstancesGET /groups/{groupId}/instancesGet Group Instances
GroupsApigetGroupInvitesGET /groups/{groupId}/invitesGet Group Invites Sent
GroupsApigetGroupMemberGET /groups/{groupId}/members/{userId}Get Group Member
GroupsApigetGroupMembersGET /groups/{groupId}/membersList Group Members
GroupsApigetGroupPermissionsGET /groups/{groupId}/permissionsList Group Permissions
GroupsApigetGroupPostsGET /groups/{groupId}/postsGet posts from a Group
GroupsApigetGroupRequestsGET /groups/{groupId}/requestsGet Group Join Requests
GroupsApigetGroupRoleTemplatesGET /groups/roleTemplatesGet Group Role Templates
GroupsApigetGroupRolesGET /groups/{groupId}/rolesGet Group Roles
GroupsApijoinGroupPOST /groups/{groupId}/joinJoin Group
GroupsApikickGroupMemberDELETE /groups/{groupId}/members/{userId}Kick Group Member
GroupsApileaveGroupPOST /groups/{groupId}/leaveLeave Group
GroupsApiremoveGroupMemberRoleDELETE /groups/{groupId}/members/{userId}/roles/{groupRoleId}Remove Role from GroupMember
GroupsApirespondGroupJoinRequestPUT /groups/{groupId}/requests/{userId}Respond Group Join request
GroupsApisearchGroupsGET /groupsSearch Group
GroupsApiunbanGroupMemberDELETE /groups/{groupId}/bans/{userId}Unban Group Member
GroupsApiupdateGroupPUT /groups/{groupId}Update Group
GroupsApiupdateGroupGalleryPUT /groups/{groupId}/galleries/{groupGalleryId}Update Group Gallery
GroupsApiupdateGroupMemberPUT /groups/{groupId}/members/{userId}Update Group Member
GroupsApiupdateGroupPostPUT /groups/{groupId}/posts/{notificationId}Edits a Group post
GroupsApiupdateGroupRepresentationPUT /groups/{groupId}/representationUpdate Group Representation
GroupsApiupdateGroupRolePUT /groups/{groupId}/roles/{groupRoleId}Update Group Role
InstancesApicloseInstanceDELETE /instances/{worldId}:{instanceId}Close Instance
InstancesApicreateInstancePOST /instancesCreate Instance
InstancesApigetInstanceGET /instances/{worldId}:{instanceId}Get Instance
InstancesApigetInstanceByShortNameGET /instances/s/{shortName}Get Instance By Short Name
InstancesApigetShortNameGET /instances/{worldId}:{instanceId}/shortNameGet Instance Short Name
InventoryApigetInventoryGET /inventoryGet Inventory
InventoryApigetInventoryDropsGET /inventory/dropsList Inventory Drops
InventoryApigetInventoryTemplateGET /inventory/template/{inventoryTemplateId}Get Inventory Template
InventoryApigetOwnInventoryItemGET /inventory/{inventoryItemId}Get Own Inventory Item
InventoryApispawnInventoryItemGET /inventory/spawnSpawn Inventory Item
InviteApigetInviteMessageGET /message/{userId}/{messageType}/{slot}Get Invite Message
InviteApigetInviteMessagesGET /message/{userId}/{messageType}List Invite Messages
InviteApiinviteMyselfToPOST /invite/myself/to/{worldId}:{instanceId}Invite Myself To Instance
InviteApiinviteUserPOST /invite/{userId}Invite User
InviteApiinviteUserWithPhotoPOST /invite/{userId}/photoInvite User with photo
InviteApirequestInvitePOST /requestInvite/{userId}Request Invite
InviteApirequestInviteWithPhotoPOST /requestInvite/{userId}/photoRequest Invite with photo
InviteApiresetInviteMessageDELETE /message/{userId}/{messageType}/{slot}Reset Invite Message
InviteApirespondInvitePOST /invite/{notificationId}/responseRespond Invite
InviteApirespondInviteWithPhotoPOST /invite/{notificationId}/response/photoRespond Invite with photo
InviteApiupdateInviteMessagePUT /message/{userId}/{messageType}/{slot}Update Invite Message
JamsApigetJamGET /jams/{jamId}Show jam information
JamsApigetJamSubmissionsGET /jams/{jamId}/submissionsShow jam submissions
JamsApigetJamsGET /jamsShow jams list
MiscellaneousApigetAssignedPermissionsGET /auth/permissionsGet Assigned Permissions
MiscellaneousApigetCSSGET /css/app.cssDownload CSS
MiscellaneousApigetConfigGET /configFetch API Config
MiscellaneousApigetCurrentOnlineUsersGET /visitsCurrent Online Users
MiscellaneousApigetHealthGET /healthCheck API Health
MiscellaneousApigetInfoPushGET /infoPushShow Information Notices
MiscellaneousApigetJavaScriptGET /js/app.jsDownload JavaScript
MiscellaneousApigetPermissionGET /permissions/{permissionId}Get Permission
MiscellaneousApigetSystemTimeGET /timeCurrent System Time
NotificationsApiacceptFriendRequestPUT /auth/user/notifications/{notificationId}/acceptAccept Friend Request
NotificationsApiclearNotificationsPUT /auth/user/notifications/clearClear All Notifications
NotificationsApideleteNotificationPUT /auth/user/notifications/{notificationId}/hideDelete Notification
NotificationsApigetNotificationGET /auth/user/notifications/{notificationId}Show notification
NotificationsApigetNotificationsGET /auth/user/notificationsList Notifications
NotificationsApimarkNotificationAsReadPUT /auth/user/notifications/{notificationId}/seeMark Notification As Read
PlayermoderationApiclearAllPlayerModerationsDELETE /auth/user/playermoderationsClear All Player Moderations
PlayermoderationApigetPlayerModerationsGET /auth/user/playermoderationsSearch Player Moderations
PlayermoderationApimoderateUserPOST /auth/user/playermoderationsModerate User
PlayermoderationApiunmoderateUserPUT /auth/user/unplayermoderateUnmoderate User
PrintsApideletePrintDELETE /prints/{printId}Delete Print
PrintsApieditPrintPOST /prints/{printId}Edit Print
PrintsApigetPrintGET /prints/{printId}Get Print
PrintsApigetUserPrintsGET /prints/user/{userId}Get Own Prints
PrintsApiuploadPrintPOST /printsUpload Print
PropsApigetPropGET /props/{propId}Get Prop
UsersApiaddTagsPOST /users/{userId}/addTagsAdd User Tags
UsersApicheckUserPersistenceExistsGET /users/{userId}/{worldId}/persist/existsCheck User Persistence Exists
UsersApideleteUserPersistenceDELETE /users/{userId}/{worldId}/persistDelete User Persistence
UsersApigetUserGET /users/{userId}Get User by ID
UsersApigetUserByNameGET /users/{username}/nameGet User by Username
UsersApigetUserFeedbackGET /users/{userId}/feedbackGet User Feedback
UsersApigetUserGroupInstancesGET /users/{userId}/instances/groupsGet User Group Instances
UsersApigetUserGroupRequestsGET /users/{userId}/groups/requestedGet User Group Requests
UsersApigetUserGroupsGET /users/{userId}/groupsGet User Groups
UsersApigetUserNoteGET /userNotes/{userNoteId}Get User Note
UsersApigetUserNotesGET /userNotesGet User Notes
UsersApigetUserRepresentedGroupGET /users/{userId}/groups/representedGet user's current represented group
UsersApiremoveTagsPOST /users/{userId}/removeTagsRemove User Tags
UsersApisearchUsersGET /usersSearch All Users
UsersApiupdateBadgePUT /users/{userId}/badges/{badgeId}Update User Badge
UsersApiupdateUserPUT /users/{userId}Update User Info
UsersApiupdateUserNotePOST /userNotesUpdate User Note
WorldsApicheckUserPersistenceExistsGET /users/{userId}/{worldId}/persist/existsCheck User Persistence Exists
WorldsApicreateWorldPOST /worldsCreate World
WorldsApideleteUserPersistenceDELETE /users/{userId}/{worldId}/persistDelete User Persistence
WorldsApideleteWorldDELETE /worlds/{worldId}Delete World
WorldsApigetActiveWorldsGET /worlds/activeList Active Worlds
WorldsApigetFavoritedWorldsGET /worlds/favoritesList Favorited Worlds
WorldsApigetRecentWorldsGET /worlds/recentList Recent Worlds
WorldsApigetWorldGET /worlds/{worldId}Get World by ID
WorldsApigetWorldInstanceGET /worlds/{worldId}/{instanceId}Get World Instance
WorldsApigetWorldMetadataGET /worlds/{worldId}/metadataGet World Metadata
WorldsApigetWorldPublishStatusGET /worlds/{worldId}/publishGet World Publish Status
WorldsApipublishWorldPUT /worlds/{worldId}/publishPublish World
WorldsApisearchWorldsGET /worldsSearch All Worlds
WorldsApiunpublishWorldDELETE /worlds/{worldId}/publishUnpublish World
WorldsApiupdateWorldPUT /worlds/{worldId}Update World

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

authHeader

  • Type: HTTP basic authentication

authCookie

  • Type: API key
  • API key parameter name: auth
  • Location:

twoFactorAuthCookie

  • Type: API key
  • API key parameter name: twoFactorAuth
  • Location:

Author

vrchatapi.lpv0t@aries.fyi