Skip to content

ICommands

v1 stable

/ICommands/v1/

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

Authentication required

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

DELETE /ICommands/v1/Delete

Deletes a slash command by its commandId.

Query Parameters

Field Type
commandId
uuid

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://gateway.argon.zone/ICommands/v1/Delete?commandId=..."
GET /ICommands/v1/List

Lists all commands registered by this bot across all scopes.

Response CommandListResponse

Field Type
commands BotCommand[]
↳ commandId uuid
↳ name string
↳ description string
↳ spaceId uuid | null
↳ defaultPermission boolean
↳ options BotCommandOption[]
↳ name string
↳ description string
↳ type BotCommandOptionType
↳ required boolean | null
↳ choices CommandChoice[] | null
↳ name string
↳ value any
↳ subOptions BotCommandOption[] | null (circular)

Example

curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://gateway.argon.zone/ICommands/v1/List
GET /ICommands/v1/ListForSpace

Lists commands available in a specific space (global + space-scoped).

Query Parameters

Field Type
spaceId
uuid

Response CommandListResponse

Field Type
commands BotCommand[]
↳ commandId uuid
↳ name string
↳ description string
↳ spaceId uuid | null
↳ defaultPermission boolean
↳ options BotCommandOption[]
↳ name string
↳ description string
↳ type BotCommandOptionType
↳ required boolean | null
↳ choices CommandChoice[] | null
↳ name string
↳ value any
↳ subOptions BotCommandOption[] | null (circular)

Example

curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     "https://gateway.argon.zone/ICommands/v1/ListForSpace?spaceId=..."
POST /ICommands/v1/Register

Registers a slash command, or updates the bot's command of the same name in the same scope. Commands can be global or scoped to a specific space. Max 50 commands per scope.

Request Body RegisterCommandRequest

Field Type
name
string
description
string
spaceId
uuid | null
options
BotCommandOption[] | null
↳ name
string
↳ description
string
↳ type
BotCommandOptionType
↳ required
boolean | null
↳ choices
CommandChoice[] | null
↳ name
string
↳ value
any
↳ subOptions
BotCommandOption[] | null (circular)
defaultPermission
boolean | null

Response CommandRegisteredResponse

Field Type
commandId uuid
name string
spaceId uuid | 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 '{"name":"...","description":"...","spaceId":null,"options":null,"defaultPermission":null}' \
     https://gateway.argon.zone/ICommands/v1/Register
PATCH /ICommands/v1/Update

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

Request Body UpdateCommandRequest

Field Type
commandId
uuid
description
string | null
options
BotCommandOption[] | null
↳ name
string
↳ description
string
↳ type
BotCommandOptionType
↳ required
boolean | null
↳ choices
CommandChoice[] | null
↳ name
string
↳ value
any
↳ subOptions
BotCommandOption[] | null (circular)
defaultPermission
boolean | null

Response BotCommand

Field Type
commandId uuid
name string
description string
spaceId uuid | null
defaultPermission boolean
options BotCommandOption[]
↳ name string
↳ description string
↳ type BotCommandOptionType
↳ required boolean | null
↳ choices CommandChoice[] | null
↳ name string
↳ value any
↳ subOptions BotCommandOption[] | null (circular)

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":"...","description":null,"options":null,"defaultPermission":null}' \
     https://gateway.argon.zone/ICommands/v1/Update