channels.timeline

What happened, newest first, for a channel, an agent, a call or Decibyl.

Reference

GET/api/v1/timeline

Auth

API key in X-API-Key

Content

none

Returns

200 · TimelineResponse

One feed, four screens. No filter gives the account's whole history; ``workflow_id`` gives one bot's; ``workflow_run_id`` gives one call, and that one reads *forwards* because a call is a story. ``deliverables_only`` gives the Deliverables list. The db layer owns that ordering rule -- see ``agent_events``.

Arguments

Argument	In	Type	Required	Description
workflow_id	query	integer	optional
workflow_run_id	query	integer	optional
folder_id	query	integer	optional
assistant	query	boolean	default false
thread_id	query	string	optional
kinds	query	string[]	optional
deliverables_only	query	boolean	default false
include_transcripts	query	boolean	default false
limit	query	integer	default 100
before_at	query	datetime	optional
before_id	query	integer	optional

Example request

curl -X GET "https://api.decibyl.ai/api/v1/timeline" \
  -H "X-API-Key: dcb_your_key"

Response

{
  "events": [
    {
      "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": []
      }
    }
  ],
  "next_before_at": "2026-09-14T09:30:00Z",
  "next_before_id": 1,
  "truncated": false
}

Errors

Status	When
404	Not found
422	Validation Error