Skip to main content
Revolt logo

Overview

Add Revolt to any ModuleX agent or workflow. Open-source chat platform for group management and social features via the Revolt REST API (revolt.chat/api).
Categories: Communication · Auth: Session Token · Actions: 3

Authentication

Session Token

Authenticate using your Revolt session token (sent as x-session-token header)

Required Credentials

FieldDescriptionRequiredFormat
Session TokenYour Revolt session token from the Revolt clientYes-

Available Actions

Parameters

name
string
required
The name of the group
description
string
Group description
users
array
IDs of the users to add to the group
nsfw
boolean
Whether this group is age-restricted

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "channel_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Channel Id"
    },
    "channel_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Channel Type"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "owner": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Owner"
    },
    "nsfw": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Nsfw"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateGroupOutput",
  "type": "object"
}

Parameters

target
string
required
ID of the group channel
member
string
required
ID of the user to add

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "AddGroupMemberOutput",
  "type": "object"
}

Parameters

username
string
required
Username and discriminator combo separated by #

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "user_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "User Id"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    }
  },
  "required": [
    "success"
  ],
  "title": "SendFriendRequestOutput",
  "type": "object"
}

Limits & Quotas

  • No officially documented rate limits for the Revolt API.
  • Error model: non-2xx responses and timeouts are caught and returned as success=False + error rather than raising.

AgentMail

Gmail

Google Meet