Skip to content
Changelog

Report a bug

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

    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

See How connections work for access and permissions, or browse all integrations.

Reference date: October 29, 2026. Revolt API docs.