ICommands

v1 stable

/api/bot/ICommands/v1/

Register, update, list, and delete slash commands for your bot.

0c93ed62652e9b97… SHA-256 contract hash — guaranteed stable

Authentication required

All endpoints require Authorization: Bot <token> header. Get a token →

DELETE /api/bot/ICommands/v1/Delete

Deletes a slash command by its commandId (query parameter).

Response DeletedResponse

Field Type
deleted boolean

Errors

Status Code Description
404 not_found Command does not exist or is not owned by this bot.

Example

$ curl -X DELETE \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://api.argon.gl/api/bot/ICommands/v1/Delete
GET /api/bot/ICommands/v1/List

Lists all commands registered by this bot across all scopes.

Response CommandListResponse

Field Type
commands BotCommand[]
↳ commandId string
↳ defaultPermission boolean
↳ description string
↳ name string
↳ options BotCommandOption[]
↳ choices CommandChoice[]
↳ name string
↳ value any
↳ description string
↳ name string
↳ required boolean
↳ subOptions BotCommandOption[] (circular)
↳ type "string" | "integer" | "boolean" | "user" | "channel" | "role" | "number"
↳ spaceId string | null

Example

$ curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://api.argon.gl/api/bot/ICommands/v1/List
GET /api/bot/ICommands/v1/ListForSpace

Lists commands available in a specific space (global + space-scoped). Pass spaceId as a query parameter.

Response CommandListResponse

Field Type
commands BotCommand[]
↳ commandId string
↳ defaultPermission boolean
↳ description string
↳ name string
↳ options BotCommandOption[]
↳ choices CommandChoice[]
↳ name string
↳ value any
↳ description string
↳ name string
↳ required boolean
↳ subOptions BotCommandOption[] (circular)
↳ type "string" | "integer" | "boolean" | "user" | "channel" | "role" | "number"
↳ spaceId string | null

Example

$ curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://api.argon.gl/api/bot/ICommands/v1/ListForSpace
POST /api/bot/ICommands/v1/Register

Registers a new slash command. Commands can be global or scoped to a specific space. Max 50 commands per scope.

Request Body RegisterCommandRequest

Field Type
defaultPermission boolean | null
description string
name string
options BotCommandOption[]
↳ choices CommandChoice[]
↳ name string
↳ value any
↳ description string
↳ name string
↳ required boolean
↳ subOptions BotCommandOption[] (circular)
↳ type "string" | "integer" | "boolean" | "user" | "channel" | "role" | "number"
spaceId string | null

Response CommandRegisteredResponse

Field Type
commandId string
name string
spaceId string | null

Errors

Status Code Description
400 command_limit Maximum 50 commands per scope.
400 invalid_description Description must be max 100 characters.
400 invalid_name Name must be 1-32 lowercase alphanumeric characters.

Example

$ curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"defaultPermission":null,"description":"...","name":"...","options":[],"spaceId":null}' \
     https://api.argon.gl/api/bot/ICommands/v1/Register
PATCH /api/bot/ICommands/v1/Update

Updates an existing slash command's description, options, or default permission.

Request Body UpdateCommandRequest

Field Type
commandId string
defaultPermission boolean | null
description string
options BotCommandOption[]
↳ choices CommandChoice[]
↳ name string
↳ value any
↳ description string
↳ name string
↳ required boolean
↳ subOptions BotCommandOption[] (circular)
↳ type "string" | "integer" | "boolean" | "user" | "channel" | "role" | "number"

Response BotCommand

Field Type
commandId string
defaultPermission boolean
description string
name string
options BotCommandOption[]
↳ choices CommandChoice[]
↳ name string
↳ value any
↳ description string
↳ name string
↳ required boolean
↳ subOptions BotCommandOption[] (circular)
↳ type "string" | "integer" | "boolean" | "user" | "channel" | "role" | "number"
spaceId string | null

Errors

Status Code Description
404 not_found Command does not exist or is not owned by this bot.

Example

$ curl -X PATCH \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"commandId":"...","defaultPermission":null,"description":"...","options":[]}' \
     https://api.argon.gl/api/bot/ICommands/v1/Update