Get a playbook run timeline

View as Markdown
Returns the run's append-only event timeline in chronological order — event types include run_started, step, task_completed, action_proposed, approval_requested, approval_decided, action_dispatched, action_awaiting_input, action_completed, action_failed, action_skipped, output_review_requested, output_edited, steer, pause, resume, stop_requested, run_completed, run_failed, run_cancelled. Authorization: `space:read` (org admins bypass); missing → 404. Query: `after` (cursor = last event id already seen, for polling forward) and `limit` (1–200). Returns `{ data: TimelineItem[], has_more }`. Capability redaction: callers WITHOUT `space:contribute` receive event payloads sanitized (artifact URLs / storage keys stripped), so read-only viewers never get signed file links.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired
runIdstringRequired

Query parameters

afterstringOptional>=1 character

Cursor: the id of the last event already seen.

limitintegerOptional1-200Defaults to 50

Page size, 1–200. Defaults to 50.

Response

One page of timeline events, oldest first.
datalist of objects
has_moreboolean