channels.decide

Answer a question an agent asked.

Reference

POST/api/v1/timeline/decide

Auth: API key in X-API-Key
Content: application/json
Returns: 200 · TimelineEvent

Answer a bot's question on the card that asked it. The answer is written into the question's own row, so the card everyone sees shows what was decided and by whom; it is also posted as a message in the channel and handed to the bot, which carries on with it. A question already answered stays answered: the bot has acted on the first answer.

Arguments

Argument	In	Type	Required
`event_id`	body	`integer`	required
`choice`	body	`string[]`	optional
`other`	body	`string`	optional

Example request

curl -X POST "https://api.decibyl.ai/api/v1/timeline/decide" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"event_id":1,"choice":["string"],"other":"string"}'

Response

{
  "id": 1,
  "at": "2026-09-14T09:30:00Z",
  "kind": "string",
  "actor": "string",
  "summary": "string",
  "payload": {},
  "is_deliverable": true,
  "workflow_id": 1,
  "workflow_run_id": 1,
  "folder_id": 1,
  "credits": 0,
  "included": true,
  "blocked": {
    "reason": "string",
    "says": "string",
    "ways": []
  }
}

Errors

Status	When
`404`	Not found
`422`	Validation Error