Get the additive thread timeline projection

GET/v1/threads/{threadId}/timeline

Return canonical events together with run projections, deliveries, activity groups, and a bounded read-only compatibility projection of legacy messages, logs, and steps. No cursor returns the newest canonical page in chronological order; use before=olderCursor for history and after=streamCursor for newer committed events.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
NameLocationTypeRequiredDescription
threadIdpathstringYesThread ID
Query parameters
NameLocationTypeRequiredDescription
afterqueryintegerNo
beforequeryintegerNo
cursorqueryintegerNoBackward-compatible alias for `before`.
limitqueryintegerNo
includeLegacyquerybooleanNo

Body schema

This endpoint does not require a request body.

None.

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Thread timeline projectionapplication/json
None.
Get the additive thread timeline projection
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow