Dois Papo para Desenvolvedores

Fetch Owned Bots

Fetch all of the bots that you have control over.

🔑 Requer autenticação

200

Create Bot

Create a new Revolt bot.

🔑 Requer autenticação

{
  "name": "texto"
}

200

Delete Bot

Delete a bot by its id.

🔑 Requer autenticação

204

Fetch Bot

Fetch details of a bot you own by its id.

🔑 Requer autenticação

200

Edit Bot

Edit bot details by its id.

🔑 Requer autenticação

{
  "name": "texto",
  "public": true,
  "analytics": true,
  "interactions_url": "texto",
  "remove": []
}

200

Fetch Public Bot

Fetch details of a public (or owned) bot by its id.

🔑 Requer autenticação

200

Invite Bot

Invite a bot to a server or group by its id.`

🔑 Requer autenticação

204

Create Group

Create a new group channel.

🔑 Requer autenticação

{
  "name": "texto",
  "description": "texto",
  "icon": "texto",
  "users": [],
  "nsfw": true
}

200

Gets all webhooks

Gets all webhooks inside the channel

🔑 Requer autenticação

200

Creates a webhook

Creates a webhook which 3rd party platforms can use to send messages

🔑 Requer autenticação

{
  "name": "texto",
  "avatar": "texto"
}

200

Remove Member from Group

Removes a user from the group.

🔑 Requer autenticação

204

Add Member to Group

Adds another user to the group.

🔑 Requer autenticação

204

Close Channel

Deletes a server channel, leaves a group or closes a group.

🔑 Requer autenticação

204

Fetch Channel

Fetch channel by its id.

🔑 Requer autenticação

200

Edit Channel

Edit a channel object by its id.

🔑 Requer autenticação

{
  "name": "texto",
  "description": "texto",
  "owner": "texto",
  "icon": "texto",
  "nsfw": true,
  "archived": true,
  "voice": "…",
  "slowmode": 0
}

200

Acknowledge Message

Lets the server and all other clients know that we've seen this message id in this channel.

🔑 Requer autenticação

204

Stop Ring

Stops ringing a specific user in a dm call. You must be in the call to use this endpoint, returns NotConnected otherwise. Only valid in DM/Group channels, will return NoEffect in servers. Returns NotFound if the user is not in the dm/group channel

🔑 Requer autenticação

204

Create Invite

Creates an invite to this channel. Channel must be a `TextChannel`.

🔑 Requer autenticação

200

Join Call

Asks the voice server for a token to join the call.

🔑 Requer autenticação

{
  "node": "texto",
  "force_disconnect": true,
  "recipients": []
}

200

Fetch Group Members

Retrieves all users who are part of this group. This may not return full user information if users are not friends but have mutual connections.

🔑 Requer autenticação

200

Fetch Messages

Fetch multiple messages.

🔑 Requer autenticação

200

Send Message

Sends a message to the given channel.

🔑 Requer autenticação

{
  "nonce": "texto",
  "content": "texto",
  "attachments": [],
  "replies": [],
  "embeds": [],
  "masquerade": "…",
  "interactions": "…",
  "flags": 0
}

200

Bulk Delete Messages

Delete multiple messages you've sent or one you have permission to delete. This will always require `ManageMessages` permission regardless of whether you own the message or not. Messages must have been sent within the past 1 week.

🔑 Requer autenticação

{
  "ids": []
}

204

Delete Message

Delete a message you've sent or one you have permission to delete.

🔑 Requer autenticação

204

Fetch Message

Retrieves a message by its id.

🔑 Requer autenticação

200

Edit Message

Edits a message that you've previously sent.

🔑 Requer autenticação

{
  "content": "texto",
  "embeds": []
}

200

Unpins a message

Unpins a message by its id.

🔑 Requer autenticação

204

Pins a message

Pins a message by its id.

🔑 Requer autenticação

204

Remove All Reactions from Message

Remove your own, someone else's or all of a given reaction. Requires `ManageMessages` permission.

🔑 Requer autenticação

204

Remove Reaction(s) to Message

Remove your own, someone else's or all of a given reaction. Requires `ManageMessages` if changing others' reactions.

🔑 Requer autenticação

204

Add Reaction to Message

React to a given message.

🔑 Requer autenticação

204

Set Default Permission

Sets permissions for the default role in this channel. Channel must be a `Group` or `TextChannel`.

🔑 Requer autenticação

200

Set Role Permission

Sets permissions for the specified role in this channel. Channel must be a `TextChannel`.

🔑 Requer autenticação

{
  "permissions": "…"
}

200

Search for Messages

This route searches for messages within the given parameters.

🔑 Requer autenticação

{
  "query": "texto",
  "pinned": true,
  "limit": 0,
  "before": "texto",
  "after": "texto",
  "sort": "…",
  "include_users": true
}

200

Create Server

Create a new server.

🔑 Requer autenticação

{
  "name": "texto",
  "description": "texto",
  "nsfw": true
}

200

Kick Member

Removes a member from the server.

🔑 Requer autenticação

204

Fetch Member

Retrieve a member.

🔑 Requer autenticação

200

Edit Member

Edit a member by their id.

🔑 Requer autenticação

{
  "nickname": "texto",
  "pronouns": "texto",
  "avatar": "texto",
  "roles": [],
  "timeout": "…",
  "can_publish": true,
  "can_receive": true,
  "voice_channel": "texto"
}

200

Unban user

Remove a user's ban.

🔑 Requer autenticação

204

Ban User

Ban a user by their id.

🔑 Requer autenticação

{
  "reason": "texto",
  "delete_message_seconds": 0
}

200

Create Channel

Create a new Text or Voice channel.

🔑 Requer autenticação

{
  "type": "…",
  "name": "texto",
  "description": "texto",
  "nsfw": true,
  "voice": "…"
}

200

Delete / Leave Server

Deletes a server if owner otherwise leaves.

🔑 Requer autenticação

204

Fetch Server

Fetch a server by its id.

🔑 Requer autenticação

200

Edit Server

Edit a server by its id.

🔑 Requer autenticação

{
  "name": "texto",
  "description": "texto",
  "icon": "texto",
  "banner": "texto",
  "categories": [],
  "system_messages": "…",
  "flags": 0,
  "discoverable": true
}

200

Mark Server As Read

Mark all channels in a server as read.

🔑 Requer autenticação

204

Audit Log Query

Queries a server's audit logs.

🔑 Requer autenticação

200

Fetch Bans

Fetch all bans on a server.

🔑 Requer autenticação

200

Fetch Server Emoji

Fetch all emoji on a server.

🔑 Requer autenticação

200

Fetch Invites

Fetch all server invites.

🔑 Requer autenticação

200

Fetch Members

Fetch all server members.

🔑 Requer autenticação

200

Query members by name

Query members by a given name, this API is not stable and will be removed in the future.

🔑 Requer autenticação

200

Set Default Permission

Sets permissions for the default role in this server.

🔑 Requer autenticação

{
  "permissions": 0
}

200

Set Role Permission

Sets permissions for the specified role in the server.

🔑 Requer autenticação

{
  "permissions": "…"
}

200

Create Role

Creates a new server role.

🔑 Requer autenticação

{
  "name": "texto",
  "rank": 0
}

200

Edits server roles ranks

Edit's server role's ranks.

🔑 Requer autenticação

{
  "ranks": []
}

200

Delete Role

Delete a server role by its id.

🔑 Requer autenticação

204

Fetch Role

Fetch a role by its id.

🔑 Requer autenticação

200

Edit Role

Edit a role by its id.

🔑 Requer autenticação

{
  "name": "texto",
  "colour": "texto",
  "hoist": true,
  "rank": 0,
  "icon": "texto",
  "remove": []
}

200

Fetch Self

Retrieve your user information.

🔑 Requer autenticação

200

Change Username

Change your username.

🔑 Requer autenticação

{
  "username": "texto",
  "password": "texto"
}

200

Fetch Direct Message Channels

This fetches your direct messages, including any DM and group DM conversations.

🔑 Requer autenticação

200

Send Friend Request

Send a friend request to another user.

🔑 Requer autenticação

{
  "username": "texto"
}

200

Fetch User

Retrieve a user's information.

🔑 Requer autenticação

200

Edit User

Edit currently authenticated user.

🔑 Requer autenticação

{
  "display_name": "texto",
  "pronouns": "texto",
  "avatar": "texto",
  "status": "…",
  "profile": "…",
  "badges": 0,
  "flags": 0,
  "remove": []
}

200

Unblock User

Unblock another user by their id.

🔑 Requer autenticação

200

Block User

Block another user by their id.

🔑 Requer autenticação

200

Fetch Default Avatar

This returns a default avatar based on the given id.

200

Open Direct Message

Open a DM with another user. If the target is oneself, a saved messages channel is returned.

🔑 Requer autenticação

200

Fetch User Flags

Retrieve a user's flags.

200

Deny Friend Request / Remove Friend

Denies another user's friend request or removes an existing friend.

🔑 Requer autenticação

200

Accept Friend Request

Accept another user's friend request.

🔑 Requer autenticação

200

Fetch Mutual Friends, Servers, Groups and DMs

Retrieve a list of mutual friends, servers, groups and DMs with another user.

🔑 Requer autenticação

200

Fetch User Profile

Retrieve a user's profile data. Will fail if you do not have permission to access the other user's profile.

🔑 Requer autenticação

200

Delete Invite

Delete an invite by its id.

🔑 Requer autenticação

204

Fetch Invite

Fetch an invite by its id.

200

Join Invite

Join an invite by its ID

🔑 Requer autenticação

200

Fetch Account

Fetch account information from the current session.

🔑 Requer autenticação

200

Change Email

Change the associated account email.

🔑 Requer autenticação

{
  "email": "texto",
  "current_password": "texto"
}

204

Change Password

Change the current account password.

🔑 Requer autenticação

{
  "password": "texto",
  "current_password": "texto"
}

204

Create Account

Create a new account.

{
  "email": "texto",
  "password": "texto",
  "invite": "texto",
  "captcha": "texto"
}

204

Delete Account

Request to have an account deleted.

🔑 Requer autenticação

204

Confirm Account Deletion

Schedule an account for deletion by confirming the received token.

{
  "token": "texto"
}

204

Disable Account

Disable an account.

🔑 Requer autenticação

204

Password Reset

Confirm password reset and change the password.

{
  "token": "texto",
  "password": "texto",
  "remove_sessions": true
}

204

Send Password Reset

Send an email to reset account password.

{
  "email": "texto",
  "captcha": "texto"
}

204

Resend Verification

Resend account creation verification email.

{
  "email": "texto",
  "captcha": "texto"
}

204

Verify Email

Verify an email address.

200

MFA Status

Fetch MFA status of an account.

🔑 Requer autenticação

200

Get MFA Methods

Fetch available MFA methods.

🔑 Requer autenticação

200

Generate Recovery Codes

Re-generate recovery codes for an account.

🔑 Requer autenticação

200

Fetch Recovery Codes

Fetch recovery codes for an account.

🔑 Requer autenticação

200

Create MFA ticket

Create a new MFA ticket or validate an existing one.

🔑 Requer autenticação

200

Disable TOTP 2FA

Disable TOTP 2FA for an account.

🔑 Requer autenticação

204

Generate TOTP Secret

Generate a new secret for TOTP.

🔑 Requer autenticação

200

Enable TOTP 2FA

Generate a new secret for TOTP.

🔑 Requer autenticação

204

Delete All Sessions

Delete all active sessions, optionally including current one.

🔑 Requer autenticação

204

Fetch Sessions

Fetch all sessions associated with this account.

🔑 Requer autenticação

200

Login

Login to an account.

200

Logout

Delete current session.

🔑 Requer autenticação

204

Revoke Session

Delete a specific active session.

🔑 Requer autenticação

204

Edit Session

Edit current session information.

🔑 Requer autenticação

{
  "friendly_name": "texto"
}

200

Fetch Settings

Fetch settings from server filtered by keys. This will return an object with the requested keys, each value is a tuple of `(timestamp, value)`, the value is the previously uploaded data.

🔑 Requer autenticação

{
  "keys": []
}

200

Set Settings

Upload data to save to settings.

🔑 Requer autenticação

204

Fetch Unreads

Fetch information about unread state on channels.

🔑 Requer autenticação

200

Push Subscribe

Create a new Web Push subscription. If an existing subscription exists on this session, it will be removed.

🔑 Requer autenticação

{
  "endpoint": "texto",
  "p256dh": "texto",
  "auth": "texto"
}

204

Unsubscribe

Remove the Web Push subscription associated with the current session.

🔑 Requer autenticação

204

Complete Onboarding

This sets a new username, completes onboarding and allows a user to start using Revolt.

🔑 Requer autenticação

{
  "username": "texto"
}

200

Check Onboarding Status

This will tell you whether the current account requires onboarding or whether you can continue to send requests as usual. You may skip calling this if you're restoring an existing session.

🔑 Requer autenticação

200

Report Content

Report a piece of content to the moderation team.

🔑 Requer autenticação

{
  "content": "…",
  "additional_context": "texto"
}

204

Delete Emoji

Delete an emoji by its id.

🔑 Requer autenticação

204

Fetch Emoji

Fetch an emoji by its id.

200

Edit Emoji

Edit an emoji by its id.

🔑 Requer autenticação

{
  "name": "texto"
}

200

Create New Emoji

Create an emoji by its Autumn upload id.

🔑 Requer autenticação

{
  "name": "texto",
  "parent": "…",
  "nsfw": true
}

200

Acknowledge Policy Changes

Accept/acknowledge changes to platform policy.

🔑 Requer autenticação

204