Revolt (Stoat)

Delete Bot. Delete a bot by its id. DELETE /bots/{bot_id}.

Delete bot 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.

Remove Member from Group. Removes a user from the group. DELETE /channels/{group_id}/recipients/{member_id}.

Close Channel. Deletes a server channel, leaves a group or closes a group. DELETE /channels/{target}.

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.

Delete Message. Delete a message you've sent or one you have permission to delete. DELETE /channels/{target}/messages/{msg}.

Unpins a message. Unpins a message by its id. DELETE /channels/{target}/messages/{msg}/pin.

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.

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}.

Delete Emoji. Delete an emoji by its id. DELETE /custom/emoji/{emoji_id}.

Delete Invite. Delete an invite by its id. DELETE /invites/{target}.

Unban user. Remove a user's ban. DELETE /servers/{server}/bans/{target}.

Delete server 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.

Kick Member. Removes a member from the server. DELETE /servers/{server_id}/members/{member_id}.

Delete / Leave Server. Deletes a server if owner otherwise leaves. DELETE /servers/{target}.

Delete Role. Delete a server role by its id. DELETE /servers/{target}/roles/{role_id}.

Unblock User. Unblock another user by their id. DELETE /users/{target}/block.

Deny Friend Request / Remove Friend. Denies another user's friend request or removes an existing friend. DELETE /users/{target}/friend.

Deletes a webhook. DELETE /webhooks/{webhook_id}.

Query Node. Fetch the server configuration for this Revolt instance. GET /.

Get bot 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.

Fetch Public Bot. Fetch details of a public (or owned) bot by its id. GET /bots/{target}/invite.

Gets all webhooks. Gets all webhooks inside the channel GET /channels/{channel_id}/webhooks.

Fetch Channel. Fetch channel by its id. GET /channels/{target}.

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.

Fetch Messages. Fetch multiple messages. GET /channels/{target}/messages.

Fetch Message. Retrieves a message by its id. GET /channels/{target}/messages/{msg}.

Fetch Emoji. Fetch an emoji by its id. GET /custom/emoji/{emoji_id}.

Fetch Invite. Fetch an invite by its id. GET /invites/{target}.

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. NEEDS A USER SESSION TOKEN: onboarding state belongs to a user account, and measured 2026-09-17 a valid bot token is refused 401 here. A connection made with the Bot token card cannot call this tool and will be told so before the request is made.

Get server 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.

Fetch Member. Retrieve a member. GET /servers/{server_id}/members/{member_id}.

Fetch Server. Fetch a server by its id. GET /servers/{target}.

Audit Log Query. Queries a server's audit logs. GET /servers/{target}/audit_logs. ONE FILTER IS NOT AVAILABLE THROUGH THIS TOOL: an ARRAY-typed filter whose query-string wire form is unmeasured. A bot identity cannot create a server (400 IsBot, measured 2026-09-17) and this wave's bot is in none, so every audit-log request answers 404 before a filter is parsed -- there was no way to tell `type=a&type=b` from `type[]=a&type[]=b`, and the wrong one returns an unfiltered 200 a caller cannot distinguish from a correct answer. Settle it by calling GET /servers/{id}/audit_logs on a real server with one known-present action type and one invented value, and compare the two result counts.

Fetch Bans. Fetch all bans on a server. GET /servers/{target}/bans.

Fetch Server Emoji. Fetch all emoji on a server. GET /servers/{target}/emojis.

Fetch Invites. Fetch all server invites. GET /servers/{target}/invites.

Fetch Members. Fetch all server members. GET /servers/{target}/members.

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.

Fetch Role. Fetch a role by its id. GET /servers/{target}/roles/{role_id}.

Fetch Unreads. Fetch information about unread state on channels. GET /sync/unreads.

Fetch User. Retrieve a user's information. GET /users/{target}.

Open Direct Message. Open a DM with another user. If the target is oneself, a saved messages channel is returned. GET /users/{target}/dm.

Fetch User Flags. Retrieve a user's flags. GET /users/{target}/flags.

Fetch Mutual Friends, Servers, Groups and DMs. Retrieve a list of mutual friends, servers, groups and DMs with another user. GET /users/{target}/mutual.

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.

Fetch Direct Message Channels. This fetches your direct messages, including any DM and group DM conversations. GET /users/dms.

Fetch Self. Retrieve your user information. GET /users/@me.

Gets a webhook. GET /webhooks/{webhook_id}.

Edit Channel. Edit a channel object by its id. PATCH /channels/{target}.

Edit Message. Edits a message that you've previously sent. PATCH /channels/{target}/messages/{msg}.

Edit Emoji. Edit an emoji by its id. PATCH /custom/emoji/{emoji_id}.

Edit Member. Edit a member by their id. PATCH /servers/{server_id}/members/{member_id}.

Edit Server. Edit a server by its id. PATCH /servers/{target}.

Edit Role. Edit a role by its id. PATCH /servers/{target}/roles/{role_id}.

Edits server roles ranks. Edit's server role's ranks. PATCH /servers/{target}/roles/ranks.

Edit User. Edit currently authenticated user. PATCH /users/{target}.

Edits a webhook. PATCH /webhooks/{webhook_id}.

Invite Bot. Invite a bot to a server or group by its id.` POST /bots/{target}/invite.

Creates a webhook. Creates a webhook which 3rd party platforms can use to send messages POST /channels/{channel_id}/webhooks.

Create Invite. Creates an invite to this channel. Channel must be a TextChannel. POST /channels/{target}/invites.

Join Call. Asks the voice server for a token to join the call. POST /channels/{target}/join_call.

Send Message. Sends a message to the given channel. POST /channels/{target}/messages.

Pins a message. Pins a message by its id. POST /channels/{target}/messages/{msg}/pin.

Search for Messages. This route searches for messages within the given parameters. POST /channels/{target}/search.

Create Group. Create a new group channel. POST /channels/create.

Join Invite. Join an invite by its ID POST /invites/{target}.

Complete Onboarding. This sets a new username, completes onboarding and allows a user to start using Revolt. POST /onboard/complete. NEEDS A USER SESSION TOKEN: onboarding completes a user account, and measured 2026-09-17 a valid bot token is refused 401 here. A connection made with the Bot token card cannot call this tool and will be told so before the request is made.

Acknowledge Policy Changes. Accept/acknowledge changes to platform policy. POST /policy/acknowledge.

Push Subscribe. Create a new Web Push subscription. If an existing subscription exists on this session, it will be removed. POST /push/subscribe. NEEDS A USER SESSION TOKEN: push subscriptions belong to a user session, and measured 2026-09-17 a valid bot token is refused 401 here. A connection made with the Bot token card cannot call this tool and will be told so before the request is made.

Unsubscribe. Remove the Web Push subscription associated with the current session. POST /push/unsubscribe. NEEDS A USER SESSION TOKEN: push subscriptions belong to a user session, and measured 2026-09-17 a valid bot token is refused 401 here. A connection made with the Bot token card cannot call this tool and will be told so before the request is made.

Report Content. Report a piece of content to the moderation team. POST /safety/report.

Create Channel. Create a new Text or Voice channel. POST /servers/{server}/channels.

Create Role. Creates a new server role. POST /servers/{target}/roles.

Create Server. Create a new server. POST /servers/create. NOT AVAILABLE TO BOT IDENTITIES: Revolt refuses server creation to bot identities: measured 2026-09-17, a valid bot token answers 400 {"type":"IsBot"}. A human account creates the server and invites the bot to it.

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.

Set Settings. Upload data to save to settings. POST /sync/settings/set.

Send Friend Request. Send a friend request to another user. POST /users/friend.

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.

Add Member to Group. Adds another user to the group. PUT /channels/{group_id}/recipients/{member_id}.

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}.

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}.

Add Reaction to Message. React to a given message. PUT /channels/{target}/messages/{msg}/reactions/{emoji}.

Set channel role permissions. Sets permissions for the specified role in this channel. Channel must be a TextChannel. PUT /channels/{target}/permissions/{role_id}.

Set default channel permissions. Sets permissions for the default role in this channel. Channel must be a Group or TextChannel. PUT /channels/{target}/permissions/default.

Create New Emoji. Create an emoji by its Autumn upload id. PUT /custom/emoji/{emoji_id}.

Ban User. Ban a user by their id. PUT /servers/{server}/bans/{target}.

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.

Mark Server As Read. Mark all channels in a server as read. PUT /servers/{target}/ack.

Set server role permissions. Sets permissions for the specified role in the server. PUT /servers/{target}/permissions/{role_id}.

Set default server permissions. Sets permissions for the default role in this server. PUT /servers/{target}/permissions/default.

Block User. Block another user by their id. PUT /users/{target}/block.

Accept Friend Request. Accept another user's friend request. PUT /users/{target}/friend.