Get a Session Thread

GET /api/v1/forward/sessions/{session_id}/threads/{thread_id}

Request headers

Header	Required	Description
Authorization	Yes	`Bearer <PAT or SAT>`

Path parameters

Parameter	Type	Required	Description
session_id	string	Yes	Session ID with the `sess_` prefix.
thread_id	string	Yes	Thread ID with the `sthr_` prefix that belongs to the Session.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/sessions/sess_xxx/threads/sthr_child_xxx' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "id": "sthr_child_xxx",
  "type": "session_thread",
  "session_id": "sess_xxx",
  "parent_thread_id": "sthr_coordinator_xxx",
  "template_id": "tmpl_worker",
  "name": "research",
  "role": "child",
  "status": "idle",
  "stop_reason": { "type": "end_turn" },
  "created_by_tool_use_id": "toolu_xxx",
  "created_at": "2026-06-22T11:00:00Z",
  "updated_at": "2026-06-22T11:05:00Z"
}

The response is a Thread object.

Errors

HTTP	Type	Code	Condition
401	`authentication_error`	`authentication_required`	The PAT or SAT is invalid or expired.
404	`not_found`	`session_not_found`	The Session does not exist or is not visible to the caller.
404	`not_found_error`	`thread_not_found`	The Thread does not exist or does not belong to the Session.
502	`api_error`	`runtime_unavailable`	The Thread runtime service is temporarily unavailable.

Notes

This endpoint can retrieve archived Threads and is the authoritative source for final Thread state.
Thread lifecycle Events are for notification and recovery. Do not use them as the only source of an archive result.

Get a Session Thread

Request headers

Path parameters

Example request

Example response

Errors

Notes

List Session Threads

Archive a Session Thread

​Request headers

​Path parameters

​Example request

​Example response

​Errors

​Notes

List Session Threads

Archive a Session Thread

Request headers

Path parameters

Example request

Example response

Errors

Notes