Skip to main content
Revolt logo
  • Category: communication
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 26
  • Triggers: 0
  • Slug: REVOLT
  • Version: 20261101_00

Tools

Slug: REVOLT_ACKNOWLEDGE_POLICY_CHANGESTool to acknowledge platform policy changes. Use when accepting or confirming policy updates for your bot account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_ADD_CHANNELS_MESSAGES_REACTIONSTool to add a reaction to a message in a channel. Use when you want to react with an emoji to a specific message. Returns success on completion.

Input Parameters

string
required
The ID of the message to react to
string
required
The emoji to use for the reaction. Can be a unicode emoji or custom emoji ID. Provide the raw emoji character (e.g., 👍) or custom emoji ID - encoding is handled automatically.
string
required
The ID of the channel containing the message

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_BLOCK_USERTool to block another user by their ID. Use when you need to prevent interactions with a specific user.

Input Parameters

string
required
The ID of the user to block

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_CREATE_SYNC_SETTINGS_SETTool to upload and save settings data to Revolt’s sync storage. Use when you need to persist user settings or preferences.

Input Parameters

object
required
Key-value pairs of settings to save. Keys and values must be strings.
integer
Timestamp of settings change in milliseconds. Used to avoid feedback loops.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_DELETE_MESSAGETool to delete a message you’ve sent or one you have permission to delete. Use when you need to remove a message from a channel.

Input Parameters

string
required
The ID of the channel containing the message to delete
string
required
The ID of the message to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_DELETE_MESSAGES_BULKTool to bulk delete multiple messages from a channel. Use when you need to delete multiple messages at once. Requires ManageMessages permission regardless of message ownership. Messages must have been sent within the past 1 week.

Input Parameters

string
required
The ID of the channel containing the messages to delete
array
required
List of message IDs to delete. Messages must have been sent within the past 1 week. You must either own the messages or have ManageMessages permission.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_FETCH_OWNED_BOTSTool to fetch all bots that you have control over. Use when you need to retrieve information about bots owned by the authenticated user account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_FETCH_SYNC_SETTINGSFetch server sync settings by key. Returns a settings object mapping returned keys to objects containing their timestamp and value.

Input Parameters

array
required
List of setting keys to fetch from the server

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_FETCH_USERTool to fetch detailed information about a user. Use when you have a valid user ID and need full account details. Call after authenticating with bot token.

Input Parameters

string
required
The ID of the user to fetch

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_FETCH_USER_FLAGSTool to fetch flags associated with a specific user. Use after obtaining the user ID to inspect their special statuses or roles.

Input Parameters

string
required
The unique identifier of the user whose flags will be fetched

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_API_INFOTool to fetch the server configuration for this Revolt instance. Use when you need to discover API version, feature availability, WebSocket endpoints, or service URLs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_CHANNELTool to fetch a channel by its ID. Use when you need to retrieve detailed information about a specific channel.

Input Parameters

string
required
The ID of the channel to fetch

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_CURRENT_USERTool to retrieve your own user information. Use when you need to fetch details about the authenticated user account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_INVITETool to fetch detailed information about an invite by its code. Use when you have a valid invite code and need to retrieve invite details including server info, channel info, and member count.

Input Parameters

string
required
The invite code to fetch (e.g., ‘API’, ‘abc123’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_SYNC_UNREADSTool to fetch information about unread state on channels. Use when you need to check which channels have unread messages or mentions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_USER_PROFILETool to retrieve a user’s profile data including bio and background. Use when you need profile-specific information beyond basic user data. Will fail if you do not have permission to access the target user’s profile.

Input Parameters

string
required
The ID of the user whose profile to fetch

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_USERS_DEFAULT_AVATARTool to fetch a user’s default avatar image based on their ID. Use when you need to retrieve the default avatar picture for a specific user.

Input Parameters

string
required
The ID of the user whose default avatar will be fetched

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_USERS_DMTool to open a DM with another user. Use when you need to start or access a direct message conversation. If the target is oneself, returns a saved messages channel.

Input Parameters

string
required
The ID of the user to open a DM with. If the target is the authenticated user themselves, a saved messages channel is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_GET_USERS_DMSTool to fetch all direct message conversations for the authenticated user. Use when you need to list all DM and group DM channels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_PIN_MESSAGETool to pin a message in a channel by its ID. Use when you need to highlight important messages for channel members.

Input Parameters

string
required
The ID of the message to pin
string
required
The ID of the channel containing the message

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_REMOVE_MESSAGE_REACTIONTool to remove a reaction from a message. Use when you need to remove your own, someone else’s, or all reactions of a given emoji from a message. Requires ManageMessages permission if removing others’ reactions.

Input Parameters

string
required
The ID of the message to remove the reaction from
string
required
The emoji to remove from the message (can be unicode emoji or custom emoji ID)
string
required
The ID of the channel containing the message
string
Remove a specific user’s reaction. Requires ManageMessages permission if removing others’ reactions. If not specified, removes your own reaction.
boolean
Remove all reactions of this emoji type from the message. Requires ManageMessages permission.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_SEND_CHANNELS_MESSAGESSend a message to a Revolt channel using a bot token. The message must include nonempty text or attachments and may also include embeds.

Input Parameters

string
Deprecated: Unique token to prevent duplicate message sending. Use Idempotency-Key header instead
array
List of embeds to include in message. Text embed content contributes to the content length cap
string
required
ID of the channel to send the message to
string
Message content to send (max 2000 characters)
array
List of messages to reply to
object
Masquerade to apply to this message.
array
List of attachment file IDs to include in message
object
Information about how this message should be interacted with.
string
Unique key to prevent duplicate requests. Sent as Idempotency-Key header

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_UNBLOCK_USERUnblock another user by their ID to remove a block on that user.

Input Parameters

string
required
The ID of the user to unblock

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_UNPIN_MESSAGETool to unpin a message in a channel. Use when you need to remove a pinned message from the channel’s pinned messages list.

Input Parameters

string
required
The ID of the channel containing the message
string
required
The ID of the message to unpin

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_UPDATE_CHANNELS_MESSAGESTool to edit a message that you’ve previously sent in a channel. Use when you need to update the content or embeds of an existing message. At least one of content or embeds must be provided.

Input Parameters

string
required
The ID of the message to edit
array
Embeds to include in the message. Maximum of 10 embeds allowed.
string
required
The ID of the channel containing the message
string
New message content to replace the existing message text

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REVOLT_UPDATE_USERTool to update user information. Use when you need to modify user profile or status fields. Call after authenticating with bot token.

Input Parameters

array
List of profile fields to clear
string
Avatar file ID to set as new avatar
string
required
The ID of the user to update
string
New status text for the user
string
Profile content asset ID or base64 data
string
Profile background asset ID or base64 data

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not