channels.settleEdit

Publish or discard a change an agent proposed to itself.

Reference

POST/api/v1/timeline/edits/settle

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

Publish or discard a change a bot proposed to itself, from its card. The action is written into the card's own row, so everyone who opens the thread afterwards sees what was decided and by whom; the draft is published or discarded in the same call.

Arguments

Argument	In	Type	Required
`event_id`	body	`integer`	required
`action`	body	`string`	required
`edits`	body	`EditedField[]`	optional

Example request

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