API Reference

All Bot API interfaces with their routes, request/response types, and versioning status. Every request requires Authorization: Bot <token> header.

16 interfaces · 48 routes

OpenAPI specification

The whole Bot API as a single OpenAPI 3.0 document, generated from the running routes. Feed it to openapi-generator and get a typed client in your language instead of writing one.

Download openapi.json

Always current, straight from the gateway:
https://gateway.argon.zone/openapi.json

Generate a client:
openapi-generator-cli generate -i openapi.json -g python -o ./argon-bot

IArchetypes

v1 stable

3 routes

List and inspect archetypes (roles) in a space. Permissions are hidden unless the bot has ManageArchetype entitlement.

GET /Get GET /List GET /ListMembers

IBotSelf

v1 stable

2 routes

Get information about the authenticated bot and its spaces.

GET /GetMe GET /GetSpaces

ICalls

v20260401 draft

3 routes

Receive and manage incoming calls. Verified bots only.

POST /Accept POST /Reject GET /Ringing

IChannels

v1 stable

3 routes

Create, list, and delete channels within a space.

POST /Create DELETE /Delete GET /List

ICommands

v1 stable

5 routes

DELETE /Delete GET /List GET /ListForSpace POST /Register PATCH /Update

IEvents

v1 stable

1 route

Subscribe to real-time events via Server-Sent Events (SSE). Receive messages, member changes, voice activity, and more.

GET /Stream

IExpressions

v1 stable

7 routes

Read a space's sticker and custom emoji packs and add to them. Bots change only the packs and items they made, and never delete or reorder. Writing takes CreateExpressions among the bot's required entitlements.

POST /AddItem POST /CreatePack GET /GetPack GET /GetQuota GET /List PATCH /UpdateItem PATCH /UpdatePack

IFiles

v1 stable

2 routes

Upload files once and use them by fileId: stickers and emoji for IExpressions/AddItem, attachments for IMessages/Send. An upload is kept for 24 hours; at most 100 unused uploads per bot.

GET /Get POST /Upload