channels.settleAction

Confirm, decline or undo an action an agent proposed.

Reference

POST/api/v1/timeline/actions/settle

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

Confirm, decline or undo a proposed action on the card that proposed it. Confirm arms it and it fires after a short undo window; undo inside that window cancels it, and after it ran puts it back if it can be. Every press is stamped into the proposal's own row, so the card is the record.

Arguments

Argument	In	Type	Required
`event_id`	body	`integer`	required
`verb`	body	`string`	required
`version`	body	`string`	optional

Example request

curl -X POST "https://api.decibyl.ai/api/v1/timeline/actions/settle" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"event_id":1,"verb":"string","version":"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