Getting Started

Bots are created through the Argon Developer Console.

1. Go to console.argon.gl and sign in with your Argon account.
2. Select your team (or create one).
3. Navigate to Apps and click Create Application.
4. Choose the Bot App tab.
5. Enter an App Name (e.g., "My Music Bot") and a Bot Username.

After creating the bot, you'll be taken to the App Details page. Find the Authentication & Keys section.

Your bot token looks like this:

Bot Token:
a1b2c3d4e5f6...:aBC-_DeF_GhIjKlMnOpQr...

Format: {hex}:{base64url} — the first part identifies the bot, the second is the secret.

Include your token in the Authorization header on every request:

Authorization: Bot YOUR_TOKEN_HERE

All API endpoints require this header. Requests without it receive a 401 Unauthorized response.

The Bot API is organized into interfaces, each independently versioned. Every endpoint follows this pattern:

Base URL:
https://api.argon.gl/api/bot/{Interface}/v{Version}/{Method}

Example:
https://api.argon.gl/api/bot/IBotSelf/v1/GetMe

Verify your bot is authenticated by calling GetMe:

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

{
  "botId": "550e8400-e29b-41d4-a716-446655440000",
  "userId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "username": "music_bot",
  "displayName": "Music Bot",
  "avatarUrl": null,
  "email": "550e8400...+music_bot@noreply.argon.gl"
}

If you receive a 200 OK with your bot info, you're all set.

Each interface has its own token bucket rate limit. When you hit the limit, the API returns 429 Too Many Requests with a Retry-After header indicating how many seconds to wait.

These are default limits. Verified bots receive higher rate limits automatically. If you need a further increase, contact support.

All errors follow this format:

{
  "code": "not_found",
  "message": "The requested resource was not found."
}