VRChat.Favorites (vrchat v1.20.0)
View SourceAPI calls for all endpoints tagged Favorites
.
Summary
Functions
Add Favorite
Add a new favorite. Friend groups are named group_0
through group_3
. Avatar and World groups are named avatars1
to avatars4
and worlds1
to worlds4
. You cannot add people whom you are not friends with to your friends list. Destroying a friendship removes the person as favorite on both sides.
Clear Favorite Group Clear ALL contents of a specific favorite group.
Show Favorite Group Fetch information about a specific favorite group.
List Favorite Groups
Return a list of favorite groups owned by a user. Returns the same information as getFavoriteGroups
.
Get Favorite Limits Return information about a specific Favorite.
List Favorites Returns a list of favorites.
Remove Favorite Remove a favorite from your favorites list.
Update Favorite Group Update information about a specific favorite group.
Functions
@spec add_favorite( Tesla.Env.client(), keyword() ) :: {:ok, VRChat.Model.Error.t()} | {:ok, VRChat.Model.Favorite.t()} | {:error, Tesla.Env.t()}
Add Favorite
Add a new favorite. Friend groups are named group_0
through group_3
. Avatar and World groups are named avatars1
to avatars4
and worlds1
to worlds4
. You cannot add people whom you are not friends with to your friends list. Destroying a friendship removes the person as favorite on both sides.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters:body
(AddFavoriteRequest):
Returns
{:ok, VRChat.Model.Favorite.t}
on success{:error, Tesla.Env.t}
on failure
@spec clear_favorite_group( Tesla.Env.client(), String.t(), String.t(), String.t(), keyword() ) :: {:ok, VRChat.Model.Success.t()} | {:error, Tesla.Env.t()}
Clear Favorite Group Clear ALL contents of a specific favorite group.
Parameters
connection
(VRChat.Connection): Connection to serverfavorite_group_type
(String.t): The type of group to fetch, must be a valid FavoriteType.favorite_group_name
(String.t): The name of the group to fetch, must be a name of a FavoriteGroup.user_id
(String.t): Must be a valid user ID.opts
(keyword): Optional parameters
Returns
{:ok, VRChat.Model.Success.t}
on success{:error, Tesla.Env.t}
on failure
@spec get_favorite_group( Tesla.Env.client(), String.t(), String.t(), String.t(), keyword() ) :: {:ok, VRChat.Model.FavoriteGroup.t()} | {:error, Tesla.Env.t()}
Show Favorite Group Fetch information about a specific favorite group.
Parameters
connection
(VRChat.Connection): Connection to serverfavorite_group_type
(String.t): The type of group to fetch, must be a valid FavoriteType.favorite_group_name
(String.t): The name of the group to fetch, must be a name of a FavoriteGroup.user_id
(String.t): Must be a valid user ID.opts
(keyword): Optional parameters
Returns
{:ok, VRChat.Model.FavoriteGroup.t}
on success{:error, Tesla.Env.t}
on failure
@spec get_favorite_groups( Tesla.Env.client(), keyword() ) :: {:ok, [VRChat.Model.FavoriteGroup.t()]} | {:ok, VRChat.Model.Error.t()} | {:error, Tesla.Env.t()}
List Favorite Groups
Return a list of favorite groups owned by a user. Returns the same information as getFavoriteGroups
.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters:n
(integer()): The number of objects to return.:offset
(integer()): A zero-based offset from the default object sorting from where search results start.:userId
(String.t): Target user to see information on, admin-only.:ownerId
(String.t): The owner of whoms favorite groups to return. Must be a UserID.
Returns
{:ok, [%FavoriteGroup{}, ...]}
on success{:error, Tesla.Env.t}
on failure
@spec get_favorite_limits( Tesla.Env.client(), keyword() ) :: {:ok, VRChat.Model.FavoriteLimits.t()} | {:ok, VRChat.Model.Error.t()} | {:error, Tesla.Env.t()}
Get Favorite Limits Return information about a specific Favorite.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters
Returns
{:ok, VRChat.Model.FavoriteLimits.t}
on success{:error, Tesla.Env.t}
on failure
@spec get_favorites( Tesla.Env.client(), keyword() ) :: {:ok, [VRChat.Model.Favorite.t()]} | {:ok, VRChat.Model.Error.t()} | {:error, Tesla.Env.t()}
List Favorites Returns a list of favorites.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters:n
(integer()): The number of objects to return.:offset
(integer()): A zero-based offset from the default object sorting from where search results start.:type
(String.t): The type of favorites to return, FavoriteType.:tag
(String.t): Tags to include (comma-separated). Any of the tags needs to be present.
Returns
{:ok, [%Favorite{}, ...]}
on success{:error, Tesla.Env.t}
on failure
@spec remove_favorite(Tesla.Env.client(), String.t(), keyword()) :: {:ok, VRChat.Model.Success.t()} | {:ok, VRChat.Model.Error.t()} | {:error, Tesla.Env.t()}
Remove Favorite Remove a favorite from your favorites list.
Parameters
connection
(VRChat.Connection): Connection to serverfavorite_id
(String.t): Must be a valid favorite ID.opts
(keyword): Optional parameters
Returns
{:ok, VRChat.Model.Success.t}
on success{:error, Tesla.Env.t}
on failure
@spec update_favorite_group( Tesla.Env.client(), String.t(), String.t(), String.t(), keyword() ) :: {:ok, nil} | {:error, Tesla.Env.t()}
Update Favorite Group Update information about a specific favorite group.
Parameters
connection
(VRChat.Connection): Connection to serverfavorite_group_type
(String.t): The type of group to fetch, must be a valid FavoriteType.favorite_group_name
(String.t): The name of the group to fetch, must be a name of a FavoriteGroup.user_id
(String.t): Must be a valid user ID.opts
(keyword): Optional parameters:body
(UpdateFavoriteGroupRequest):
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure