Ask for a single Slack button response

POST

/api/v3/organizations/{organisation}/ai/slack-bots/{botId}/interactions

curl --request POST \
  --url https://dashboard.quantcdn.io/api/v3/organizations/example/ai/slack-bots/example/interactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "channel": "example", "threadTs": "example", "text": "example", "actions": [ { "id": "example", "label": "example", "style": "primary" } ], "responseMode": "single", "expiresInSeconds": 3600, "allowedUsers": [ "example" ], "metadata": {} }'

• QuantCDN Public Cloud
• QuantGov Cloud

External-agent interaction, not a platform tool approval. Requires explicit ai:slack, verified email and use_ai_services. The caller owns the meaning of the response. Feature must be enabled on this environment.

Authorizations

• BearerAuth

Parameters

Path Parameters

organisation

required

string

botId

required

string

Header Parameters

Idempotency-Key

required

string

>= 8 characters <= 128 characters

Request Body^required

Media typeapplication/json

object

channel

required

string

threadTs

string

text

required

string

>= 1 characters <= 3000 characters

actions

required

Array<object>

>= 1 items <= 5 items

object

id

required

string

/^[a-zA-Z0-9_-]{1,64}$/

label

required

string

>= 1 characters <= 75 characters

style

string

Allowed values: primary danger

responseMode

string

Allowed values: single

expiresInSeconds

integer

default: 3600 >= 60 <= 86400

allowedUsers

Array<string>

>= 1 items <= 50 items

metadata

Opaque caller data, at most 4096 bytes of canonical JSON

object

Responses

201

Card delivered; interaction awaits a response

202

Read returned interactionId to obtain delivery or recorded response state

400

Invalid request

403

Access denied

422

Idempotency key reused with a different request

503

Audit persistence unavailable; retry with the same key