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.
Authorization
apiKey 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)
Format
int32Range
1 <= value <= 100Default
20Response 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 }}{ "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}