Revolt

These are the Revolt actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Fetch Owned Bots

  Tool to fetch all bots that you have control over. Use when you need to retrieve information about bots owned by the authenticated user account.

• Get API Info

  Tool to fetch the server configuration for this Revolt instance. Use when you need to discover API version, feature availability, WebSocket endpoints, or service URLs.

• Get Channel

  Tool to fetch a channel by its ID. Use when you need to retrieve detailed information about a specific channel.

• Get Current User

  Tool to retrieve your own user information. Use when you need to fetch details about the authenticated user account.

• Get Invite

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

• Get User DMs

  Tool to fetch all direct message conversations for the authenticated user. Use when you need to list all DM and group DM channels.

• Get User Profile

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

• Open DM with User

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

• Send Channel Message

  Tool to send a message to a Revolt channel. Use when you need to post a text message, embed, or attachment to a specific channel. Call after authenticating with bot token.

• Update Channel Message

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

• Acknowledge Policy Changes

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

• Add Reaction to Message

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

• Block User

  Tool to block another user by their ID. Use when you need to prevent interactions with a specific user.

• Bulk Delete Messages

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

• Create Sync Settings

  Tool to upload and save settings data to Revolt's sync storage. Use when you need to persist user settings or preferences.

• Delete Message

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

• Fetch Sync Settings

  Tool to fetch settings from server filtered by keys. Returns an object with the requested keys where each value is a tuple of (timestamp, value). Only settings that exist on the server will be included in the response.

• Fetch user

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

• Fetch User Flags

  Tool to fetch flags associated with a specific user. Use after obtaining the user ID to inspect their special statuses or roles.

• Get Sync Unreads

  Tool to fetch information about unread state on channels. Use when you need to check which channels have unread messages or mentions.

• Get User's Default Avatar

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

• Pin Message

  Tool to pin a message in a channel by its ID. Use when you need to highlight important messages for channel members.

• Remove Message Reaction

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

• Unblock User

  Tool to unblock another user by their ID. Use when you need to remove a block on a specific user. The relationship status will change from 'Blocked' to 'None' after successful execution.

• Unpin Message

  Tool to unpin a message in a channel. Use when you need to remove a pinned message from the channel's pinned messages list.

• Update User

  Tool to update user information. Use when you need to modify user profile or status fields. Call after authenticating with bot token.