Session Thread のアーカイブ

POST /api/v1/forward/sessions/{session_id}/threads/{thread_id}/archive アーカイブできるのは role=child かつ status=idle の Thread だけです。coordinator Thread はアーカイブできません。

リクエストパラメーター

場所	パラメーター	型	必須	説明
Header	Authorization	string	はい	`Bearer <PAT または SAT>`
Header	Idempotency-Key	string	いいえ	1 回の論理的なアーカイブ試行を識別します。新しい試行ごとに一意の値を使用してください。
Path	session_id	string	はい	`sess_` プレフィックス付きの Session ID。
Path	thread_id	string	はい	`sthr_` プレフィックス付きの Thread ID。

リクエストボディは空です。

リクエスト例

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"

レスポンス例

{
  "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"
}

アーカイブ済み child Thread を再度アーカイブした場合も、現在の Thread オブジェクトと HTTP 200 OK が返されます。レスポンスは Thread オブジェクトです。

エラー

HTTP	Type	Code	条件
401	`authentication_error`	`authentication_required`	PAT または SAT が無効または期限切れです。
404	`not_found`	`session_not_found`	Session が存在しないか、呼び出し元から参照できません。
404	`not_found_error`	`thread_not_found`	Thread が存在しないか、その Session に属していません。
409	`conflict_error`	`coordinator_thread_not_archivable`	coordinator Thread をアーカイブしようとしました。
409	`conflict_error`	`thread_not_idle`	child Thread が現在 `idle` ではありません。
502	`api_error`	`runtime_unavailable`	ランタイムサービスが利用できないか、競合後の状態照合に失敗しました。

注記

同じ Idempotency-Key では、キャッシュ済みの非 5xx レスポンスが再生されます。409 thread_not_idle の後に状態が変わって再試行する場合は、新しい key を使用してください。
不明確な 502 runtime_unavailable は同じ key で再試行できます。
最終状態は Thread 取得エンドポイントで確認し、session.thread_status_terminated Event だけに依存しないでください。

Session Thread のアーカイブ

リクエストパラメーター

リクエスト例

レスポンス例

エラー

注記

Session Thread の取得

Session Thread の一覧

​リクエストパラメーター

​リクエスト例

​レスポンス例

​エラー

​注記

Session Thread の取得

Session Thread の一覧

リクエストパラメーター

リクエスト例

レスポンス例

エラー

注記