Skip to main content
GET
/
threads
/
{threadId}
/
events
/
stream
Stream Thread events
curl --request GET \
  --url http://localhost:8787/api/v1/threads/{threadId}/events/stream \
  --header 'Authorization: Bearer <token>'
": connected\n\nevent: thread.event\nid: 01J00000000000000000000010\ndata: {\"id\":\"01J00000000000000000000010\",\"type\":\"run.started\",\"status\":\"completed\",\"content\":\"01J0000000000000000000000A\",\"occurredAt\":\"2026-05-19T00:00:01.000Z\",\"durationMs\":null,\"tokens\":null}\n\n"

Authorizations

​
Authorization
string
header
required

Use Authorization: Bearer grt_pat_... . API tokens identify an account and do not carry scopes.

Path Parameters

​
threadId
string<ulid>
required

Thread ID returned by create thread. v1 IDs are bare ULIDs.

Pattern: ^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$
Example:

"01J00000000000000000000009"

Query Parameters

​
limit
integer
default:100

Maximum number of latest Thread events to return.

Required range: 1 <= x <= 1000

Response

Thread event stream.

The response is of type string.