Revolt integration: operations for AI agents
Revolt connects to Type.com as an integration. This page lists the 131 operations documented for Claude and Codex in Type.com: 40 read, 45 write, 46 destructive.
About Revolt
Stoat API (formerly Revolt) reference operations, subject to Type setup and account permissions.
Categories: Email & Messaging
How to connect Revolt to Type.com
- Connect
- Configure provider-specific API target and authentication setup.
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
131 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
131 operations listed.
Core
- Read
Query Node
Fetch the server configuration for this Revolt instance.
GET /
User Information
- Read
Fetch Self
Retrieve your user information.
GET /users/@me - Read
Fetch User
Retrieve a user's information.
GET /users/{target} - Read
Fetch User Flags
Retrieve a user's flags.
GET /users/{target}/flags - Read
Fetch Default Avatar
This returns a default avatar based on the given id.
GET /users/{target}/default_avatar - Read
Fetch User Profile
Retrieve a user's profile data. Will fail if you do not have permission to access the other user's profile.
GET /users/{target}/profile - Write
Change Username
Change your username.
PATCH /users/@me/username - Destructive
Edit User
Edit currently authenticated user.
PATCH /users/{target}
Direct Messaging
- Read
Fetch Direct Message Channels
This fetches your direct messages, including any DM and group DM conversations.
GET /users/dms - Read
Open Direct Message
Open a DM with another user. If the target is oneself, a saved messages channel is returned.
GET /users/{target}/dm
Relationships
- Read
Fetch Mutual Friends, Servers, Groups and DMs
Retrieve a list of mutual friends, servers, groups and DMs with another user.
GET /users/{target}/mutual - Write
Accept Friend Request
Accept another user's friend request.
PUT /users/{target}/friend - Write
Block User
Block another user by their id.
PUT /users/{target}/block - Write
Send Friend Request
Send a friend request to another user.
POST /users/friend - Destructive
Deny Friend Request / Remove Friend
Denies another user's friend request or removes an existing friend.
DELETE /users/{target}/friend - Destructive
Unblock User
Unblock another user by their id.
DELETE /users/{target}/block
Bots
- Read
Fetch Public Bot
Fetch details of a public (or owned) bot by its id.
GET /bots/{target}/invite - Read
Fetch Bot
Fetch details of a bot you own by its id.
GET /bots/{bot_id} - Read
Fetch Owned Bots
Fetch all of the bots that you have control over.
GET /bots/@me - Write
Create Bot
Create a new Revolt bot.
POST /bots/create - Write
Invite Bot
Invite a bot to a server or group by its id.`
POST /bots/{target}/invite - Destructive
Delete Bot
Delete a bot by its id.
DELETE /bots/{bot_id} - Destructive
Edit Bot
Edit bot details by its id.
PATCH /bots/{bot_id}
Discover
- Read
Get Discover request status
Fetches the status of your Discover request. If it has been approved or denied, the reason will be provided (if applicable). This endpoint is ONLY USEFUL in production on stoat.chat/app .
GET /bots/{bot_id}/discover - Read
Get Discover request status
Fetches the status of your Discover request. If it has been approved or denied, the reason will be provided (if applicable). This endpoint is ONLY USEFUL in production on stoat.chat/app .
GET /servers/{server}/discover - Write
Add bot to Discover
This puts your bot into the Discover request queue. This endpoint is ONLY USEFUL in production on stoat.chat/app .
PUT /bots/{bot_id}/discover - Write
Add server to Discover
This puts your server into the Discover request queue. This endpoint is ONLY USEFUL in production on stoat.chat/app .
PUT /servers/{server}/discover - Destructive
Delete Discover request
This cannot be used if your request is no longer in the queue (ie approved or rejected). If you wish to reapply after a rejection, submit another POST. This endpoint is ONLY USEFUL in production on stoat.chat/app .
DELETE /bots/{bot_id}/discover - Destructive
Delete Discover request
This cannot be used if your request is no longer in the queue (ie approved or rejected). If you wish to reapply after a rejection, submit another POST. This endpoint is ONLY USEFUL in production on stoat.chat/app .
DELETE /servers/{server}/discover
Messaging
- Read
Fetch Messages
Fetch multiple messages.
GET /channels/{target}/messages - Read
Search for Messages
This route searches for messages within the given parameters.
POST /channels/{target}/search - Read
Fetch Message
Retrieves a message by its id.
GET /channels/{target}/messages/{msg} - Write
Acknowledge Message
Lets the server and all other clients know that we've seen this message id in this channel.
PUT /channels/{target}/ack/{message} - Write
Send Message
Sends a message to the given channel.
POST /channels/{target}/messages - Write
Pins a message
Pins a message by its id.
POST /channels/{target}/messages/{msg}/pin - Write
Edit Message
Edits a message that you've previously sent.
PATCH /channels/{target}/messages/{msg} - Destructive
Unpins a message
Unpins a message by its id.
DELETE /channels/{target}/messages/{msg}/pin - Destructive
Delete Message
Delete a message you've sent or one you have permission to delete.
DELETE /channels/{target}/messages/{msg} - Destructive
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.
DELETE /channels/{target}/messages/bulk
Channel Information
- Read
Fetch Channel
Fetch channel by its id.
GET /channels/{target} - Destructive
Close Channel
Deletes a server channel, leaves a group or closes a group.
DELETE /channels/{target} - Destructive
Edit Channel
Edit a channel object by its id.
PATCH /channels/{target}
Groups
- Read
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.
GET /channels/{target}/members - Write
Create Group
Create a new group channel.
POST /channels/create - Write
Add Member to Group
Adds another user to the group.
PUT /channels/{group_id}/recipients/{member_id} - Destructive
Remove Member from Group
Removes a user from the group.
DELETE /channels/{group_id}/recipients/{member_id}
Channel Invites
- Write
Create Invite
Creates an invite to this channel. Channel must be a `TextChannel`.
POST /channels/{target}/invites
Voice
- Write
Join Call
Asks the voice server for a token to join the call.
POST /channels/{target}/join_call - Write
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
PUT /channels/{target}/end_ring/{target_user}
Channel Permissions
- Destructive
Set Role Permission
Sets permissions for the specified role in this channel. Channel must be a `TextChannel`.
PUT /channels/{target}/permissions/{role_id} - Destructive
Set Default Permission
Sets permissions for the default role in this channel. Channel must be a `Group` or `TextChannel`.
PUT /channels/{target}/permissions/default
Interactions
- Write
Add Reaction to Message
React to a given message.
PUT /channels/{target}/messages/{msg}/reactions/{emoji} - Destructive
Remove Reaction(s) to Message
Remove your own, someone else's or all of a given reaction. Requires `ManageMessages` if changing others' reactions.
DELETE /channels/{target}/messages/{msg}/reactions/{emoji} - Destructive
Remove All Reactions from Message
Remove your own, someone else's or all of a given reaction. Requires `ManageMessages` permission.
DELETE /channels/{target}/messages/{msg}/reactions
Webhooks
- Read
Gets all webhooks
Gets all webhooks inside the channel
GET /channels/{channel_id}/webhooks - Read
Gets a webhook
Gets a webhook with a token
GET /webhooks/{webhook_id}/{token} - Read
Gets a webhook
Gets a webhook
GET /webhooks/{webhook_id} - Write
Creates a webhook
Creates a webhook which 3rd party platforms can use to send messages
POST /channels/{channel_id}/webhooks - Write
Edits a webhook message
Edits a message sent by a webhook
PATCH /webhooks/{webhook_id}/{token}/{message_id} - Write
Executes a webhook
Executes a webhook and sends a message
POST /webhooks/{webhook_id}/{token} - Write
Executes a webhook specific to github
Executes a webhook specific to github and sends a message containing the relevant info about the event
POST /webhooks/{webhook_id}/{token}/github - Destructive
Deletes a webhook message
Deletes a message sent by a webhook
DELETE /webhooks/{webhook_id}/{token}/{message_id} - Destructive
Deletes a webhook
Deletes a webhook with a token
DELETE /webhooks/{webhook_id}/{token} - Destructive
Edits a webhook
Edits a webhook with a token
PATCH /webhooks/{webhook_id}/{token} - Destructive
Deletes a webhook
Deletes a webhook
DELETE /webhooks/{webhook_id} - Destructive
Edits a webhook
Edits a webhook
PATCH /webhooks/{webhook_id}
Server Information
- Read
Fetch Server
Fetch a server by its id.
GET /servers/{target} - Write
Create Server
Create a new server.
POST /servers/create - Write
Mark Server As Read
Mark all channels in a server as read.
PUT /servers/{target}/ack - Write
Create Channel
Create a new Text or Voice channel.
POST /servers/{server}/channels - Destructive
Delete / Leave Server
Deletes a server if owner otherwise leaves.
DELETE /servers/{target} - Destructive
Edit Server
Edit a server by its id.
PATCH /servers/{target}
Server Members
- Read
Fetch Members
Fetch all server members.
GET /servers/{target}/members - Read
Fetch Member
Retrieve a member.
GET /servers/{server_id}/members/{member_id} - Read
Query members by name
Query members by a given name, this API is not stable and will be removed in the future.
GET /servers/{target}/members_experimental_query - Read
Fetch Bans
Fetch all bans on a server.
GET /servers/{target}/bans - Read
Fetch Invites
Fetch all server invites.
GET /servers/{target}/invites - Destructive
Kick Member
Removes a member from the server.
DELETE /servers/{server_id}/members/{member_id} - Destructive
Edit Member
Edit a member by their id.
PATCH /servers/{server_id}/members/{member_id} - Destructive
Ban User
Ban a user by their id.
PUT /servers/{server}/bans/{target} - Destructive
Unban user
Remove a user's ban.
DELETE /servers/{server}/bans/{target}
Server Permissions
- Read
Fetch Role
Fetch a role by its id.
GET /servers/{target}/roles/{role_id} - Write
Create Role
Creates a new server role.
POST /servers/{target}/roles - Write
Edits server roles ranks
Edit's server role's ranks.
PATCH /servers/{target}/roles/ranks - Destructive
Delete Role
Delete a server role by its id.
DELETE /servers/{target}/roles/{role_id} - Destructive
Edit Role
Edit a role by its id.
PATCH /servers/{target}/roles/{role_id} - Destructive
Set Role Permission
Sets permissions for the specified role in the server.
PUT /servers/{target}/permissions/{role_id} - Destructive
Set Default Permission
Sets permissions for the default role in this server.
PUT /servers/{target}/permissions/default
Server Customisation
- Read
Fetch Server Emoji
Fetch all emoji on a server.
GET /servers/{target}/emojis
Audit Logs
- Read
Audit Log Query
Queries a server's audit logs.
GET /servers/{target}/audit_logs
Invites
- Read
Fetch Invite
Fetch an invite by its id.
GET /invites/{target} - Write
Join Invite
Join an invite by its ID
POST /invites/{target} - Destructive
Delete Invite
Delete an invite by its id.
DELETE /invites/{target}
Emojis
- Read
Fetch Emoji
Fetch an emoji by its id.
GET /custom/emoji/{emoji_id} - Write
Create New Emoji
Create an emoji by its Autumn upload id.
PUT /custom/emoji/{emoji_id} - Write
Edit Emoji
Edit an emoji by its id.
PATCH /custom/emoji/{emoji_id} - Destructive
Delete Emoji
Delete an emoji by its id.
DELETE /custom/emoji/{emoji_id}
User Safety
- Write
Report Content
Report a piece of content to the moderation team.
POST /safety/report
Account
- Read
Fetch Account
Fetch account information from the current session.
GET /auth/account/ - Write
Create Account
Create a new account.
POST /auth/account/create - Write
Resend Verification
Resend account creation verification email.
POST /auth/account/reverify - Write
Change Email
Change the associated account email.
PATCH /auth/account/change/email - Write
Verify Email
Verify an email address.
POST /auth/account/verify/{code} - Write
Send Password Reset
Send an email to reset account password.
POST /auth/account/reset_password - Destructive
Confirm Account Deletion
Schedule an account for deletion by confirming the received token.
PUT /auth/account/delete - Destructive
Delete Account
Request to have an account deleted.
POST /auth/account/delete - Destructive
Disable Account
Disable an account.
POST /auth/account/disable - Destructive
Change Password
Change the current account password.
PATCH /auth/account/change/password - Destructive
Password Reset
Confirm password reset and change the password.
PATCH /auth/account/reset_password
Session
- Read
Fetch Sessions
Fetch all sessions associated with this account.
GET /auth/session/all - Write
Login
Login to an account.
POST /auth/session/login - Write
Edit Session
Edit current session information.
PATCH /auth/session/{id} - Destructive
Logout
Delete current session.
POST /auth/session/logout - Destructive
Delete All Sessions
Delete all active sessions, optionally including current one.
DELETE /auth/session/all - Destructive
Revoke Session
Delete a specific active session.
DELETE /auth/session/{id}
MFA
- Read
MFA Status
Fetch MFA status of an account.
GET /auth/mfa/ - Read
Get MFA Methods
Fetch available MFA methods.
GET /auth/mfa/methods - Write
Create MFA ticket
Create a new MFA ticket or validate an existing one.
PUT /auth/mfa/ticket - Write
Fetch Recovery Codes
Fetch recovery codes for an account.
POST /auth/mfa/recovery - Write
Enable TOTP 2FA
Generate a new secret for TOTP.
PUT /auth/mfa/totp - Write
Generate TOTP Secret
Generate a new secret for TOTP.
POST /auth/mfa/totp - Destructive
Generate Recovery Codes
Re-generate recovery codes for an account.
PATCH /auth/mfa/recovery - Destructive
Disable TOTP 2FA
Disable TOTP 2FA for an account.
DELETE /auth/mfa/totp
Onboarding
- Read
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.
GET /onboard/hello - Write
Complete Onboarding
This sets a new username, completes onboarding and allows a user to start using Revolt.
POST /onboard/complete
Policy
- Write
Acknowledge Policy Changes
Accept/acknowledge changes to platform policy.
POST /policy/acknowledge
Web Push
- Destructive
Push Subscribe
Create a new Web Push subscription. If an existing subscription exists on this session, it will be removed.
POST /push/subscribe - Destructive
Unsubscribe
Remove the Web Push subscription associated with the current session.
POST /push/unsubscribe
Sync
- Read
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.
POST /sync/settings/fetch - Read
Fetch Unreads
Fetch information about unread state on channels.
GET /sync/unreads - Write
Set Settings
Upload data to save to settings.
POST /sync/settings/set
No operations match.
See How connections work for access and permissions, or browse all integrations.
Reference date: October 29, 2026. Revolt API docs.