# \AvatarsApi
All URIs are relative to *https://api.vrchat.cloud/api/1*
[**create_avatar**](AvatarsApi.md#create_avatar) | **POST** /avatars | Create Avatar
[**delete_avatar**](AvatarsApi.md#delete_avatar) | **DELETE** /avatars/{avatarId} | Delete Avatar
[**delete_impostor**](AvatarsApi.md#delete_impostor) | **DELETE** /avatars/{avatarId}/impostor | Delete generated Impostor
[**enqueue_impostor**](AvatarsApi.md#enqueue_impostor) | **POST** /avatars/{avatarId}/impostor/enqueue | Enqueue Impostor generation
[**get_avatar**](AvatarsApi.md#get_avatar) | **GET** /avatars/{avatarId} | Get Avatar
[**get_favorited_avatars**](AvatarsApi.md#get_favorited_avatars) | **GET** /avatars/favorites | List Favorited Avatars
[**get_impostor_queue_stats**](AvatarsApi.md#get_impostor_queue_stats) | **GET** /avatars/impostor/queue/stats | Get Impostor Queue Stats
[**get_licensed_avatars**](AvatarsApi.md#get_licensed_avatars) | **GET** /avatars/licensed | List Licensed Avatars
[**get_own_avatar**](AvatarsApi.md#get_own_avatar) | **GET** /users/{userId}/avatar | Get Own Avatar
[**search_avatars**](AvatarsApi.md#search_avatars) | **GET** /avatars | Search Avatars
[**select_avatar**](AvatarsApi.md#select_avatar) | **PUT** /avatars/{avatarId}/select | Select Avatar
[**select_fallback_avatar**](AvatarsApi.md#select_fallback_avatar) | **PUT** /avatars/{avatarId}/selectFallback | Select Fallback Avatar
[**update_avatar**](AvatarsApi.md#update_avatar) | **PUT** /avatars/{avatarId} | Update Avatar
## create_avatar
> models::Avatar create_avatar(create_avatar_request)
Create Avatar
Create an avatar. It's possible to optionally specify a ID if you want a custom one. Attempting to create an Avatar with an already claimed ID will result in a DB error.
### Parameters
**create_avatar_request** | Option<[**CreateAvatarRequest**](CreateAvatarRequest.md)> | | |
### Return type
[**models::Avatar**](Avatar.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## delete_avatar
> models::Avatar delete_avatar(avatar_id)
Delete Avatar
Delete an avatar. Notice an avatar is never fully \"deleted\", only its ReleaseStatus is set to \"hidden\" and the linked Files are deleted. The AvatarID is permanently reserved.
### Parameters
**avatar_id** | **String** | Must be a valid avatar ID. | [required] |
### Return type
[**models::Avatar**](Avatar.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## delete_impostor
> delete_impostor(avatar_id)
Delete generated Impostor
Delete generated Impostor for that avatar.
### Parameters
**avatar_id** | **String** | Must be a valid avatar ID. | [required] |
### Return type
(empty response body)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## enqueue_impostor
> models::ServiceStatus enqueue_impostor(avatar_id)
Enqueue Impostor generation
Enqueue Impostor generation for that avatar.
### Parameters
**avatar_id** | **String** | Must be a valid avatar ID. | [required] |
### Return type
[**models::ServiceStatus**](ServiceStatus.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_avatar
> models::Avatar get_avatar(avatar_id)
Get Avatar
Get information about a specific Avatar.
### Parameters
**avatar_id** | **String** | Must be a valid avatar ID. | [required] |
### Return type
[**models::Avatar**](Avatar.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_favorited_avatars
> Vec<models::Avatar> get_favorited_avatars(featured, sort, n, order, offset, search, tag, notag, release_status, max_unity_version, min_unity_version, platform, user_id)
List Favorited Avatars
Search and list favorited avatars by query filters.
### Parameters
**featured** | Option<**bool**> | Filters on featured results. | |
**sort** | Option<[**SortOption**](.md)> | The sort order of the results. | |
**n** | Option<**i32**> | The number of objects to return. | |[default to 60]
**order** | Option<[**OrderOption**](.md)> | Result ordering | |
**offset** | Option<**i32**> | A zero-based offset from the default object sorting from where search results start. | |
**search** | Option<**String**> | Filters by world name. | |
**tag** | Option<**String**> | Tags to include (comma-separated). Any of the tags needs to be present. | |
**notag** | Option<**String**> | Tags to exclude (comma-separated). | |
**release_status** | Option<[**ReleaseStatus**](.md)> | Filter by ReleaseStatus. | |
**max_unity_version** | Option<**String**> | The maximum Unity version supported by the asset. | |
**min_unity_version** | Option<**String**> | The minimum Unity version supported by the asset. | |
**platform** | Option<**String**> | The platform the asset supports. | |
**user_id** | Option<**String**> | Target user to see information on, admin-only. | |
### Return type
[**Vec<models::Avatar>**](Avatar.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_impostor_queue_stats
> models::ServiceQueueStats get_impostor_queue_stats()
Get Impostor Queue Stats
Gets service stats for queued impostor.
### Parameters
This endpoint does not need any parameter.
### Return type
[**models::ServiceQueueStats**](ServiceQueueStats.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_licensed_avatars
> Vec<models::Avatar> get_licensed_avatars(n, offset)
List Licensed Avatars
List licensed avatars.
### Parameters
**n** | Option<**i32**> | The number of objects to return. | |[default to 60]
**offset** | Option<**i32**> | A zero-based offset from the default object sorting from where search results start. | |
### Return type
[**Vec<models::Avatar>**](Avatar.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_own_avatar
> models::Avatar get_own_avatar(user_id)
Get Own Avatar
Get the current avatar for the user. This will return an error for any other user than the one logged in.
### Parameters
**user_id** | **String** | Must be a valid user ID. | [required] |
### Return type
[**models::Avatar**](Avatar.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## search_avatars
> Vec<models::Avatar> search_avatars(featured, sort, user, user_id, n, order, offset, tag, notag, release_status, max_unity_version, min_unity_version, platform)
Search Avatars
Search and list avatars by query filters. You can only search your own or featured avatars. It is not possible as a normal user to search other peoples avatars.
### Parameters
**featured** | Option<**bool**> | Filters on featured results. | |
**sort** | Option<[**SortOption**](.md)> | The sort order of the results. | |
**user** | Option<**String**> | Set to `me` for searching own avatars. | |
**user_id** | Option<**String**> | Filter by UserID. | |
**n** | Option<**i32**> | The number of objects to return. | |[default to 60]
**order** | Option<[**OrderOption**](.md)> | Result ordering | |
**offset** | Option<**i32**> | A zero-based offset from the default object sorting from where search results start. | |
**tag** | Option<**String**> | Tags to include (comma-separated). Any of the tags needs to be present. | |
**notag** | Option<**String**> | Tags to exclude (comma-separated). | |
**release_status** | Option<[**ReleaseStatus**](.md)> | Filter by ReleaseStatus. | |
**max_unity_version** | Option<**String**> | The maximum Unity version supported by the asset. | |
**min_unity_version** | Option<**String**> | The minimum Unity version supported by the asset. | |
**platform** | Option<**String**> | The platform the asset supports. | |
### Return type
[**Vec<models::Avatar>**](Avatar.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## select_avatar
> models::CurrentUser select_avatar(avatar_id)
Select Avatar
Switches into that avatar.
### Parameters
**avatar_id** | **String** | Must be a valid avatar ID. | [required] |
### Return type
[**models::CurrentUser**](CurrentUser.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## select_fallback_avatar
> models::CurrentUser select_fallback_avatar(avatar_id)
Select Fallback Avatar
Switches into that avatar as your fallback avatar.
### Parameters
**avatar_id** | **String** | Must be a valid avatar ID. | [required] |
### Return type
[**models::CurrentUser**](CurrentUser.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## update_avatar
> models::Avatar update_avatar(avatar_id, update_avatar_request)
Update Avatar
Update information about a specific avatar.
### Parameters
**avatar_id** | **String** | Must be a valid avatar ID. | [required] |
**update_avatar_request** | Option<[**UpdateAvatarRequest**](UpdateAvatarRequest.md)> | | |
### Return type
[**models::Avatar**](Avatar.md)
### Authorization
[authCookie](../README.md#authCookie)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)