Skip to content

IInteractions

v1 stable

/IInteractions/v1/

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

3a08148ef4f12b63… SHA-256 contract hash — guaranteed stable

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 string

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 string

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 string
controls ControlRowV1[]
↳ controls BotControlV1[]
↳ colour OklchColor
↳ c float
↳ h float
↳ l float
↳ customId string
↳ disabled boolean | null
↳ id string
↳ label string
↳ labelLocalizations Dictionary`2
↳ maxValues int32 | null
↳ minValues int32 | null
↳ options SelectOptionV1[]
↳ default boolean | null
↳ description string
↳ label string
↳ value string
↳ placeholder string
↳ requiredArchetypeId string | null
↳ type "button" | "stringSelect" | "userSelect" | "archetypeSelect" | "channelSelect"
↳ url string
↳ variant "callback" | "link" | null
messageId int64
text string

Errors

Status Code Description
404 message_not_found Message does not exist or was not sent by this bot.

Example

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

Reply to an interaction by sending a message to the channel. Optionally reply to a specific message via replyTo.

Request Body ReplyRequest

Field Type
channelId string
controls ControlRowV1[]
↳ controls BotControlV1[]
↳ colour OklchColor
↳ c float
↳ h float
↳ l float
↳ customId string
↳ disabled boolean | null
↳ id string
↳ label string
↳ labelLocalizations Dictionary`2
↳ maxValues int32 | null
↳ minValues int32 | null
↳ options SelectOptionV1[]
↳ default boolean | null
↳ description string
↳ label string
↳ value string
↳ placeholder string
↳ requiredArchetypeId string | null
↳ type "button" | "stringSelect" | "userSelect" | "archetypeSelect" | "channelSelect"
↳ url string
↳ variant "callback" | "link" | null
entities IMessageEntity[]
randomId int64
replyTo int64 | null
text string

Response ReplyResponse

Field Type
messageId int64

Errors

Status Code Description
403 not_a_member Bot is not a member of this space.

Example

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