VRChat.Miscellaneous (vrchat v1.20.0)

View Source

API calls for all endpoints tagged Miscellaneous.

Summary

Functions

Get Assigned Permissions Returns a list of all permissions currently granted by the user. Permissions are assigned e.g. by subscribing to VRC+.

Fetch API Config API config contains configuration that the clients needs to work properly. Currently the most important value here is clientApiKey which is used for all other API endpoints.

Download CSS Fetches the CSS code to the frontend React website.

Current Online Users Returns the current number of online users. NOTE: The response type is not a JSON object, but a simple JSON integer.

Check API Health Gets the overall health status, the server name, and the current build version tag of the API. DEPRECATED: VRChat has suddenly restricted this endpoint for unknown reasons, and now always return 401 Unauthorized.

Show Information Notices IPS (Info Push System) is a system for VRChat to push out dynamic information to the client. This is primarily used by the Quick-Menu info banners, but can also be used to e.g. alert you to update your game to the latest version. include is used to query what Information Pushes should be included in the response. If include is missing or empty, then no notices will normally be returned. This is an "any of" search. require is used to limit what Information Pushes should be included in the response. This is usually used in combination with include, and is an "all of" search.

Download JavaScript Fetches the JavaScript code to the frontend React website.

Get Permission Returns a single permission. This endpoint is pretty useless, as it returns the exact same information as /auth/permissions.

Current System Time Returns the current time of the API server. NOTE: The response type is not a JSON object, but a simple JSON string.

Functions

get_assigned_permissions(connection, opts \\ [])

@spec get_assigned_permissions(
  Tesla.Env.client(),
  keyword()
) ::
  {:ok, [VRChat.Model.Permission.t()]}
  | {:ok, VRChat.Model.Error.t()}
  | {:error, Tesla.Env.t()}

Get Assigned Permissions Returns a list of all permissions currently granted by the user. Permissions are assigned e.g. by subscribing to VRC+.

Parameters

  • connection (VRChat.Connection): Connection to server
  • opts (keyword): Optional parameters

Returns

  • {:ok, [%Permission{}, ...]} on success
  • {:error, Tesla.Env.t} on failure

get_config(connection, opts \\ [])

@spec get_config(
  Tesla.Env.client(),
  keyword()
) :: {:ok, VRChat.Model.ApiConfig.t()} | {:error, Tesla.Env.t()}

Fetch API Config API config contains configuration that the clients needs to work properly. Currently the most important value here is clientApiKey which is used for all other API endpoints.

Parameters

  • connection (VRChat.Connection): Connection to server
  • opts (keyword): Optional parameters

Returns

  • {:ok, VRChat.Model.ApiConfig.t} on success
  • {:error, Tesla.Env.t} on failure

get_css(connection, opts \\ [])

@spec get_css(
  Tesla.Env.client(),
  keyword()
) :: {:ok, VRChat.Model.Error.t()} | {:ok, String.t()} | {:error, Tesla.Env.t()}

Download CSS Fetches the CSS code to the frontend React website.

Parameters

  • connection (VRChat.Connection): Connection to server
  • opts (keyword): Optional parameters
    • :variant (String.t): Specifies which variant of the site. Public is the end-user site, while internal is the staff-only site with special pages for moderation and management.
    • :branch (String.t): Specifies which git branch the site should load frontend source code from.

Returns

  • {:ok, String.t} on success
  • {:error, Tesla.Env.t} on failure

get_current_online_users(connection, opts \\ [])

@spec get_current_online_users(
  Tesla.Env.client(),
  keyword()
) :: {:ok, integer()} | {:error, Tesla.Env.t()}

Current Online Users Returns the current number of online users. NOTE: The response type is not a JSON object, but a simple JSON integer.

Parameters

  • connection (VRChat.Connection): Connection to server
  • opts (keyword): Optional parameters

Returns

  • {:ok, integer()} on success
  • {:error, Tesla.Env.t} on failure

get_health(connection, opts \\ [])

@spec get_health(
  Tesla.Env.client(),
  keyword()
) :: {:ok, VRChat.Model.ApiHealth.t()} | {:error, Tesla.Env.t()}

Check API Health Gets the overall health status, the server name, and the current build version tag of the API. DEPRECATED: VRChat has suddenly restricted this endpoint for unknown reasons, and now always return 401 Unauthorized.

Parameters

  • connection (VRChat.Connection): Connection to server
  • opts (keyword): Optional parameters

Returns

  • {:ok, VRChat.Model.ApiHealth.t} on success
  • {:error, Tesla.Env.t} on failure

get_info_push(connection, opts \\ [])

@spec get_info_push(
  Tesla.Env.client(),
  keyword()
) :: {:ok, [VRChat.Model.InfoPush.t()]} | {:error, Tesla.Env.t()}

Show Information Notices IPS (Info Push System) is a system for VRChat to push out dynamic information to the client. This is primarily used by the Quick-Menu info banners, but can also be used to e.g. alert you to update your game to the latest version. include is used to query what Information Pushes should be included in the response. If include is missing or empty, then no notices will normally be returned. This is an "any of" search. require is used to limit what Information Pushes should be included in the response. This is usually used in combination with include, and is an "all of" search.

Parameters

  • connection (VRChat.Connection): Connection to server
  • opts (keyword): Optional parameters
    • :require (String.t): Tags to include (comma-separated). All of the tags needs to be present.
    • :include (String.t): Tags to include (comma-separated). Any of the tags needs to be present.

Returns

  • {:ok, [%InfoPush{}, ...]} on success
  • {:error, Tesla.Env.t} on failure

get_java_script(connection, opts \\ [])

@spec get_java_script(
  Tesla.Env.client(),
  keyword()
) :: {:ok, VRChat.Model.Error.t()} | {:ok, String.t()} | {:error, Tesla.Env.t()}

Download JavaScript Fetches the JavaScript code to the frontend React website.

Parameters

  • connection (VRChat.Connection): Connection to server
  • opts (keyword): Optional parameters
    • :variant (String.t): Specifies which variant of the site. Public is the end-user site, while internal is the staff-only site with special pages for moderation and management.
    • :branch (String.t): Specifies which git branch the site should load frontend source code from.

Returns

  • {:ok, String.t} on success
  • {:error, Tesla.Env.t} on failure

get_permission(connection, permission_id, opts \\ [])

@spec get_permission(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, VRChat.Model.Permission.t()}
  | {:ok, VRChat.Model.Error.t()}
  | {:error, Tesla.Env.t()}

Get Permission Returns a single permission. This endpoint is pretty useless, as it returns the exact same information as /auth/permissions.

Parameters

  • connection (VRChat.Connection): Connection to server
  • permission_id (String.t): Must be a valid permission ID.
  • opts (keyword): Optional parameters

Returns

  • {:ok, VRChat.Model.Permission.t} on success
  • {:error, Tesla.Env.t} on failure

get_system_time(connection, opts \\ [])

@spec get_system_time(
  Tesla.Env.client(),
  keyword()
) :: {:ok, DateTime.t()} | {:error, Tesla.Env.t()}

Current System Time Returns the current time of the API server. NOTE: The response type is not a JSON object, but a simple JSON string.

Parameters

  • connection (VRChat.Connection): Connection to server
  • opts (keyword): Optional parameters

Returns

  • {:ok, DateTime.t} on success
  • {:error, Tesla.Env.t} on failure