REST + SSE · Per-interface versioning · Stable contracts

Build Bots for
Argon

Send messages, stream voice, handle commands, and react to events in real-time. A developer-first API with typed contracts and hash-verified stability.

First API call
$ curl -H "Authorization: Bot YOUR_TOKEN" \
     https://api.argon.gl/api/bot/IBotSelf/v1/GetMe

{"botId":"...","userId":"...","username":"my-bot","displayName":"My Bot"}

Everything you need to build

REST + JSON

Simple HTTP endpoints. No SDK required — use curl, fetch, or any HTTP client.

SSE Events

Real-time event stream via Server-Sent Events. Filter by intents, resume on disconnect.

Slash Commands

Register commands, receive interactions. Global or per-space, with typed options.

Voice Streaming

Stream Opus audio over WebSocket ingress. Music bots, TTS, live audio — all supported.

Per-Interface Versioning

Each interface versioned independently. Stable contracts with SHA-256 hash verification.

Rate Limiting

Token bucket rate limits per bot, per interface. Retry-After headers included.

Three steps to your first bot

1

Create a Bot Application

Go to console.argon.gl → Apps → Create Application → choose Bot App → pick a username ending in _bot.

2

Authenticate

Copy your bot token from the Developer Console and include it in every request:

Authorization: Bot <your-token>
3

Send your first message

POST to the Messages interface:

POST /api/bot/IMessages/v1/Send
Content-Type: application/json

{
  "channelId": "your-channel-id",
  "text": "Hello from my bot!",
  "randomId": 1
}