Archive a Session Thread

POST /api/v1/forward/sessions/{session_id}/threads/{thread_id}/archive Only a Thread with role=child and status=idle can be archived. The coordinator Thread cannot be archived.

Request headers

Header	Required	Description
Authorization	Yes	`Bearer <PAT or SAT>`
Idempotency-Key	No	Identifies one logical archive attempt. Use a unique value for each new logical attempt.

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.

The request body is empty.

Example request

curl -s -X POST 'https://api.qoder.com/api/v1/forward/sessions/sess_xxx/threads/sthr_child_xxx/archive' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Idempotency-Key: archive-thread-20260622-001"

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": "archived",
  "stop_reason": { "type": "archive" },
  "created_by_tool_use_id": "toolu_xxx",
  "archived_at": "2026-06-22T12:00:00Z",
  "created_at": "2026-06-22T11:00:00Z",
  "updated_at": "2026-06-22T12:00:00Z"
}

Archiving an already archived child Thread also returns its current object and HTTP 200 OK. 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.
409	`conflict_error`	`coordinator_thread_not_archivable`	The request tried to archive the coordinator Thread.
409	`conflict_error`	`thread_not_idle`	The child Thread is not currently `idle`.
502	`api_error`	`runtime_unavailable`	The runtime service is unavailable or state reconciliation failed after an archive conflict.

Notes

The same Idempotency-Key replays a cached non-5xx response. After a cached 409 thread_not_idle, use a new key if the Thread state has changed and you want to retry.
Retry an ambiguous 502 runtime_unavailable with the same key.
Confirm the final state with the get Thread endpoint. Do not rely only on a session.thread_status_terminated Event.

Archive a Session Thread

Request headers

Path parameters

Example request

Example response

Errors

Notes

Get a Session Thread

List Session Threads

​Request headers

​Path parameters

​Example request

​Example response

​Errors

​Notes

Get a Session Thread

List Session Threads

Request headers

Path parameters

Example request

Example response

Errors

Notes