Agentic DevelopmentThreads

List a thread's sessions

List the agent sessions of a thread, newest first. A thread you cannot read answers 404, the same as one that does not exist.

GET
/v1/threads/{threadId}/sessions
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

threadId*string

Thread ULID

Query Parameters

state?array<>|

Lifecycle states to list; repeat the parameter to combine them. Defaults to active.

cursor?string

Opaque pagination cursor from a previous response

limit?integer

Maximum number of items to return (1–100)

Formatint32
Range1 <= value <= 100
Default20

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/v1/threads/string/sessions"
{  "items": [    {      "archived_at": "string",      "created_at": "string",      "id": "string",      "last_turn_ended_at": "string",      "project": {        "id": "string",        "name": "string",        "org": "string"      },      "thread_id": "string"    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string",    "total_count": 0  }}