Session Thread の取得

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

リクエストパラメーター

場所	パラメーター	型	必須	説明
Header	Authorization	string	はい	`Bearer <PAT または SAT>`
Path	session_id	string	はい	`sess_` プレフィックス付きの Session ID。
Path	thread_id	string	はい	この Session に属する、`sthr_` プレフィックス付きの Thread ID。

リクエスト例

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

レスポンス例

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

レスポンスは 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 に属していません。
502	`api_error`	`runtime_unavailable`	Thread ランタイムサービスが一時的に利用できません。

注記

このエンドポイントはアーカイブ済み Thread も取得でき、Thread の最終状態を判断するための信頼できる情報源です。
Thread ライフサイクル Event は通知と復旧のためのものです。アーカイブ結果の唯一の判断材料にはしないでください。

Session Thread の取得

リクエストパラメーター

リクエスト例

レスポンス例

エラー

注記

Session Thread の一覧

Session Thread のアーカイブ

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

​リクエスト例

​レスポンス例

​エラー

​注記

Session Thread の一覧

Session Thread のアーカイブ

リクエストパラメーター

リクエスト例

レスポンス例

エラー

注記