View Source VRChat.Invite (vrchat v1.11.1)

API calls for all endpoints tagged Invite.

Link to this section Summary

Functions

Get Invite Message Returns a single Invite Message. This returns the exact same information but less than getInviteMessages. Admin Credentials are required to view messages of other users! Message type refers to a different collection of messages, used during different types of responses. message = Message during a normal invite response = Message when replying to a message request = Message when requesting an invite requestResponse = Message when replying to a request for invite

List Invite Messages Returns a list of all the users Invite Messages. Admin Credentials are required to view messages of other users! Message type refers to a different collection of messages, used during different types of responses. message = Message during a normal invite response = Message when replying to a message request = Message when requesting an invite requestResponse = Message when replying to a request for invite

Invite Myself To Instance Sends self an invite to an instance

Invite User Sends an invite to a user. Returns the Notification of type invite that was sent.

Request Invite Requests an invite from a user. Returns the Notification of type requestInvite that was sent.

Reset Invite Message Resets a single Invite Message back to its original message, and then returns a list of all of them. Admin Credentials are required to update messages of other users! Resetting a message respects the rate-limit, so it is not possible to reset within the 60 minutes countdown. Resetting it does however not set the rate-limit to 60 like when editing it. It is possible to edit it right after resetting it. Trying to edit a message before the cooldown timer expires results in a 429 "Too Fast Error". Message type refers to a different collection of messages, used during different types of responses. message = Message during a normal invite response = Message when replying to a message request = Message when requesting an invite requestResponse = Message when replying to a request for invite The DELETE endpoint does not have/require any request body.

Respond Invite Respond to an invite request by sending a world invite to the requesting user. :notificationId is the ID of the requesting notification.

Update Invite Message Updates a single Invite Message and then returns a list of all of them. Admin Credentials are required to update messages of other users! Updating a message automatically sets the cooldown timer to 60 minutes. Trying to edit a message before the cooldown timer expires results in a 429 "Too Fast Error". Message type refers to a different collection of messages, used during different types of responses. message = Message during a normal invite response = Message when replying to a message request = Message when requesting an invite requestResponse = Message when replying to a request for invite

Link to this section Functions

Link to this function

get_invite_message(connection, user_id, message_type, slot, opts \\ [])

View Source
@spec get_invite_message(
  Tesla.Env.client(),
  String.t(),
  VRChat.Model.InviteMessageType.t(),
  integer(),
  keyword()
) ::
  {:ok, VRChat.Model.InviteMessage.t()}
  | {:ok, VRChat.Model.Error.t()}
  | {:error, Tesla.Env.t()}

Get Invite Message Returns a single Invite Message. This returns the exact same information but less than getInviteMessages. Admin Credentials are required to view messages of other users! Message type refers to a different collection of messages, used during different types of responses. message = Message during a normal invite response = Message when replying to a message request = Message when requesting an invite requestResponse = Message when replying to a request for invite

parameters

Parameters

  • connection (VRChat.Connection): Connection to server
  • user_id (String.t): Must be a valid user ID.
  • message_type (InviteMessageType): The type of message to fetch, must be a valid InviteMessageType.
  • slot (integer()): The message slot to fetch of a given message type.
  • opts (keyword): Optional parameters

returns

Returns

  • {:ok, VRChat.Model.InviteMessage.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

get_invite_messages(connection, user_id, message_type, opts \\ [])

View Source
@spec get_invite_messages(
  Tesla.Env.client(),
  String.t(),
  VRChat.Model.InviteMessageType.t(),
  keyword()
) ::
  {:ok, [VRChat.Model.InviteMessage.t()]}
  | {:ok, VRChat.Model.Error.t()}
  | {:error, Tesla.Env.t()}

List Invite Messages Returns a list of all the users Invite Messages. Admin Credentials are required to view messages of other users! Message type refers to a different collection of messages, used during different types of responses. message = Message during a normal invite response = Message when replying to a message request = Message when requesting an invite requestResponse = Message when replying to a request for invite

parameters

Parameters

  • connection (VRChat.Connection): Connection to server
  • user_id (String.t): Must be a valid user ID.
  • message_type (InviteMessageType): The type of message to fetch, must be a valid InviteMessageType.
  • opts (keyword): Optional parameters

returns

Returns

  • {:ok, [%InviteMessage{}, ...]} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

invite_myself_to(connection, world_id, instance_id, opts \\ [])

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

Invite Myself To Instance Sends self an invite to an instance

parameters

Parameters

  • connection (VRChat.Connection): Connection to server
  • world_id (String.t): Must be a valid world ID.
  • instance_id (String.t): Must be a valid instance ID.
  • opts (keyword): Optional parameters

returns

Returns

  • {:ok, VRChat.Model.SentNotification.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

invite_user(connection, user_id, opts \\ [])

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

Invite User Sends an invite to a user. Returns the Notification of type invite that was sent.

parameters

Parameters

  • connection (VRChat.Connection): Connection to server
  • user_id (String.t): Must be a valid user ID.
  • opts (keyword): Optional parameters
    • :body (InviteRequest): Slot number of the Invite Message to use when inviting a user.

returns

Returns

  • {:ok, VRChat.Model.SentNotification.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

request_invite(connection, user_id, opts \\ [])

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

Request Invite Requests an invite from a user. Returns the Notification of type requestInvite that was sent.

parameters

Parameters

  • connection (VRChat.Connection): Connection to server
  • user_id (String.t): Must be a valid user ID.
  • opts (keyword): Optional parameters
    • :body (RequestInviteRequest): Slot number of the Request Message to use when request an invite.

returns

Returns

  • {:ok, VRChat.Model.Notification.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

reset_invite_message(connection, user_id, message_type, slot, opts \\ [])

View Source
@spec reset_invite_message(
  Tesla.Env.client(),
  String.t(),
  VRChat.Model.InviteMessageType.t(),
  integer(),
  keyword()
) ::
  {:ok, [VRChat.Model.InviteMessage.t()]}
  | {:ok, VRChat.Model.Error.t()}
  | {:error, Tesla.Env.t()}

Reset Invite Message Resets a single Invite Message back to its original message, and then returns a list of all of them. Admin Credentials are required to update messages of other users! Resetting a message respects the rate-limit, so it is not possible to reset within the 60 minutes countdown. Resetting it does however not set the rate-limit to 60 like when editing it. It is possible to edit it right after resetting it. Trying to edit a message before the cooldown timer expires results in a 429 "Too Fast Error". Message type refers to a different collection of messages, used during different types of responses. message = Message during a normal invite response = Message when replying to a message request = Message when requesting an invite requestResponse = Message when replying to a request for invite The DELETE endpoint does not have/require any request body.

parameters

Parameters

  • connection (VRChat.Connection): Connection to server
  • user_id (String.t): Must be a valid user ID.
  • message_type (InviteMessageType): The type of message to fetch, must be a valid InviteMessageType.
  • slot (integer()): The message slot to fetch of a given message type.
  • opts (keyword): Optional parameters

returns

Returns

  • {:ok, [%InviteMessage{}, ...]} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

respond_invite(connection, notification_id, opts \\ [])

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

Respond Invite Respond to an invite request by sending a world invite to the requesting user. :notificationId is the ID of the requesting notification.

parameters

Parameters

  • connection (VRChat.Connection): Connection to server
  • notification_id (String.t): Must be a valid notification ID.
  • opts (keyword): Optional parameters
    • :body (InviteResponse): Slot number of the Response Message to use when responding to a user.

returns

Returns

  • {:ok, VRChat.Model.Notification.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

update_invite_message(connection, user_id, message_type, slot, opts \\ [])

View Source
@spec update_invite_message(
  Tesla.Env.client(),
  String.t(),
  VRChat.Model.InviteMessageType.t(),
  integer(),
  keyword()
) ::
  {:ok, [VRChat.Model.InviteMessage.t()]}
  | {:ok, VRChat.Model.Error.t()}
  | {:error, Tesla.Env.t()}

Update Invite Message Updates a single Invite Message and then returns a list of all of them. Admin Credentials are required to update messages of other users! Updating a message automatically sets the cooldown timer to 60 minutes. Trying to edit a message before the cooldown timer expires results in a 429 "Too Fast Error". Message type refers to a different collection of messages, used during different types of responses. message = Message during a normal invite response = Message when replying to a message request = Message when requesting an invite requestResponse = Message when replying to a request for invite

parameters

Parameters

  • connection (VRChat.Connection): Connection to server
  • user_id (String.t): Must be a valid user ID.
  • message_type (InviteMessageType): The type of message to fetch, must be a valid InviteMessageType.
  • slot (integer()): The message slot to fetch of a given message type.
  • opts (keyword): Optional parameters
    • :body (UpdateInviteMessageRequest): Message of what to set the invite message to.

returns

Returns

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