What Are Bots?

Bots are special Argon accounts controlled by code instead of a human. They can send messages, moderate channels, stream audio, respond to slash commands, and react to real-time events — all through a simple REST + SSE API.

Every bot has a linked user account (with a bot username suffix) and appears in member lists like any other user. Under the hood, bot requests are authenticated with a secret token and processed through the same permission system as regular users.

Every user object in the Bot API includes a flags bitmask field. Use bitwise AND to check for specific flags.

// Example: check if a user is a verified bot
const isBot      = (user.flags & 1) !== 0;
const isVerified = (user.flags & 4) !== 0;

if (isBot && isVerified) {
  // Verified bot
}

Bots can register slash commands that users invoke via the / prefix in any text channel. Commands are registered through the ICommands/v1 interface and interactions are delivered as CommandInteraction SSE events.

Option Types

Each command can accept typed options:

POST /ICommands/v1/Register
{
  "spaceId":     "...",
  "name":        "play",
  "description": "Play a song by URL or search query",
  "options": [
    {
      "name":        "query",
      "description": "Song URL or search term",
      "type":        "String",
      "required":    true
    }
  ]
}