Get a thread's timeline
Authorization
host AuthorizationBearer <token>
Checked by host({authenticate}), which maps the request to a Principal or rejects it.
In: header
Path Parameters
thread_id*string
Lowercase UUID string. Writers MUST generate UUIDv7; readers accept any lowercase UUID, so the version is not an admission rule.
Match
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Query Parameters
branch_id?string
Default: the thread's main branch.
Match
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Response Body
application/json
application/json
curl -X GET "https://example.com/v1/threads/string/timeline"{ "thread_id": "string", "branch_id": "string", "entries": [ { "event": { "actor": { "kind": "user", "principal": { "issuer": "string", "subject": "string", "tenant": "string" } }, "branch_id": "string", "epoch": 1, "event_id": "string", "prev_hash": "string", "seq": 1, "thread_id": "string", "time": 0, "critical": true, "data": { "adapter": { "name": "string", "settings": { "property1": null, "property2": null }, "version": "string" }, "agent_name": "string", "config_hash": "string", "instructions": "string", "model": { "name": "string", "provider": "string" }, "model_params": { "property1": null, "property2": null }, "parent": { "branch_id": "string", "event_id": "string", "relation": "subagent", "thread_id": "string" }, "policy": { "budget": { "max_cost_nanos": 1, "max_input_tokens": 1, "max_model_requests": 1, "max_output_tokens": 1, "max_turns": 1, "max_wall_ms": 1 }, "context": { "cache_ttl_ms": 1, "clear_results": { "exclude_tools": [ "string" ], "idle_ms": 1, "keep_recent": 0, "trigger": { "tokens": 1 } }, "compact": { "keep_tail": { "tokens": 1 }, "max_failures": 1, "trigger": { "tokens": 1 } }, "defer_threshold": { "tokens": 1 }, "defer_tools": "auto", "max_output_continuations": 0, "max_output_escalation_tokens": 1, "max_pause_continuations": 0, "reserve_tokens": 0, "restore": { "file_tokens": 0, "max_files": 0, "skill_tokens": 0, "skills_total_tokens": 0 }, "server_edits": "disabled", "spill": { "head_bytes": 0, "request_budget_bytes": 1, "tail_bytes": 0, "threshold_bytes": 1 } }, "currency": "string", "fallback": [ { "adapter": { "name": "string", "settings": { "property1": null, "property2": null }, "version": "string" }, "model": { "name": "string", "provider": "string" }, "model_params": { "property1": null, "property2": null }, "reasoning_carryover": "keep" } ], "handoffs": [ "string" ], "models": [ { "context_window": 1, "input_billing_bound": "context_window", "max_output_tokens": 1, "name": "string", "price": { "cache_read": 0, "cache_write": 0, "input": 0, "output": 0 }, "provider": "string" } ], "on_unknown_usage": "upper_bound", "output": { "max_retries": 0, "mode": "tool", "schema": { "property1": null, "property2": null }, "schema_sha256": "string" }, "permissions": { "allow": [ "string" ], "allow_bypass": true, "ask": [ "string" ], "deny": [ "string" ], "mode": "plan", "plan_exit_mode": "plan", "protected_paths": [ "string" ] }, "retry": { "base_delay_ms": 1, "crash_resends": 0, "fallback_after": 1, "fallback_scope": "turn", "heartbeat_ms": 1, "max_delay_ms": 1, "max_retries": 0, "max_retry_after_ms": 1, "max_total_wait_ms": 1 } }, "sandbox_provider": "string", "tools": [ { "dedup_window_ms": 1, "defer_loading": true, "description": "string", "ends_turn": true, "input_schema": { "property1": null, "property2": null }, "name": "string", "output_schema": { "property1": null, "property2": null }, "effect_class": "idempotent" } ] }, "type": "thread_started", "type_version": 1 }, "fork_point": true } ]}