Skip to content

IInteractions

v1 stable

/IInteractions/v1/

Respond to slash-command, control, and select interactions. Supports ack, defer, modal, reply, and edit.

Authentication required

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

POST /IInteractions/v1/Ack

Acknowledge an interaction. The client shows a brief confirmation.

Request Body AckRequest

Field Type
interactionId
uuid

Errors

Status Code Description
404 interaction_not_found Interaction does not exist or has expired.

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"interactionId":"..."}' \
     https://gateway.argon.zone/IInteractions/v1/Ack
POST /IInteractions/v1/Defer

Defer an interaction. The client shows a loading state until the bot follows up.

Request Body DeferRequest

Field Type
interactionId
uuid

Errors

Status Code Description
404 interaction_not_found Interaction does not exist or has expired.

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"interactionId":"..."}' \
     https://gateway.argon.zone/IInteractions/v1/Defer
PATCH /IInteractions/v1/EditMessage

Edit the text or controls of a message previously sent by this bot.

Request Body EditMessageRequest

Field Type
channelId
uuid
messageId
int64
text
string | null
controls
ControlRowV1[] | null
↳ controls
BotControlV1[]
↳ type
ControlType
↳ variant
any | ButtonVariant | null
↳ label
string | null
↳ labelLocalizations
object | null
↳ id
string | null
↳ url
string | null
↳ colour
any | OklchColor | null
↳ disabled
boolean | null
↳ customId
string | null
↳ placeholder
string | null
↳ minValues
int32 | null
↳ maxValues
int32 | null
↳ options
SelectOptionV1[] | null
↳ label
string
↳ value
string
↳ description
string | null
↳ default
boolean | null
↳ requiredArchetypeId
uuid | null

Example

curl -X PATCH \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"channelId":"...","messageId":"0","text":null,"controls":null}' \
     https://gateway.argon.zone/IInteractions/v1/EditMessage
POST /IInteractions/v1/Reply SendMessages

Reply to an interaction by sending a message to the channel. Optionally reply to a specific message via replyTo. Not available in announcement channels.

Request Body ReplyRequest

Field Type
channelId
uuid
text
string
randomId
int64
replyTo
int64 | null
entities
MessageEntityAttachment | MessageEntityBold | MessageEntityCapitalized | MessageEntityEmail | MessageEntityFraction | MessageEntityGif | MessageEntityHashTag | MessageEntityItalic | MessageEntityLinkPreview | MessageEntityMention | MessageEntityMentionEveryone | MessageEntityMentionRole | MessageEntityMonospace | MessageEntityOrdinal | MessageEntityQuote | MessageEntitySpoiler | MessageEntityStrikethrough | MessageEntitySystemCallEnded | MessageEntitySystemCallStarted | MessageEntitySystemCallTimeout | MessageEntitySystemUserJoined | MessageEntityUnderline | MessageEntityUrl[] | null
controls
ControlRowV1[] | null
↳ controls
BotControlV1[]
↳ type
ControlType
↳ variant
any | ButtonVariant | null
↳ label
string | null
↳ labelLocalizations
object | null
↳ id
string | null
↳ url
string | null
↳ colour
any | OklchColor | null
↳ disabled
boolean | null
↳ customId
string | null
↳ placeholder
string | null
↳ minValues
int32 | null
↳ maxValues
int32 | null
↳ options
SelectOptionV1[] | null
↳ label
string
↳ value
string
↳ description
string | null
↳ default
boolean | null
↳ requiredArchetypeId
uuid | null

Response ReplyResponse

Field Type
messageId int64

Errors

Status Code Description
400 validation_error The message is not valid for this channel.
403 cannot_send Bot may not post this message in this channel.
429 slow_mode The channel is holding messages back; retry later.

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"channelId":"...","text":"...","randomId":"0","replyTo":null,"entities":null,"controls":null}' \
     https://gateway.argon.zone/IInteractions/v1/Reply