Session Thread の一覧

GET /api/v1/forward/sessions/{session_id}/threads Thread は Session ランタイム内の実行ブランチです。coordinator Thread と、それが作成する child Thread は同じデータ構造を使用します。

リクエストパラメーター

場所	パラメーター	型	必須	デフォルト	説明
Header	Authorization	string	はい	-	`Bearer <PAT または SAT>`
Path	session_id	string	はい	-	`sess_` プレフィックス付きの Session ID。
Query	limit	integer	いいえ	20	1～100 のページサイズ。
Query	after_id	string	いいえ	-	この Thread ID より後のレコードを返します。
Query	before_id	string	いいえ	-	この Thread ID より前のレコードを返します。

after_id と before_id を同時に指定することはできません。結果は常に昇順です。このエンドポイントは order、statuses、statuses[]、include_archived をサポートしません。空の値であっても指定すると 400 invalid_request が返されます。

リクエスト例

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

レスポンス例

{
  "data": [{
    "id": "sthr_xxx",
    "type": "session_thread",
    "session_id": "sess_xxx",
    "template_id": "tmpl_support",
    "role": "coordinator",
    "status": "idle",
    "stop_reason": { "type": "end_turn" },
    "created_at": "2026-06-22T10:00:00Z",
    "updated_at": "2026-06-22T10:05:00Z"
  }],
  "first_id": "sthr_xxx",
  "last_id": "sthr_xxx",
  "has_more": false
}

フィールド	型	説明
data	array	このページの Thread オブジェクト。
first_id	string \| null	このページの最初の Thread ID。空の場合は `null`。
last_id	string \| null	このページの最後の Thread ID。空の場合は `null`。
has_more	boolean	続きのレコードがあるかどうか。

エラー

HTTP	Type	Code	条件
400	`invalid_request`	`invalid_limit`	`limit` が 1～100 の整数ではありません。
400	`invalid_request`	`invalid_pagination`	`after_id` と `before_id` を同時に指定しました。
400	`invalid_request`	`invalid_request`	サポートされていない selector を指定しました。
401	`authentication_error`	`authentication_required`	PAT または SAT が無効または期限切れです。
404	`not_found`	`session_not_found`	Session が存在しないか、呼び出し元から参照できません。
502	`api_error`	`runtime_unavailable`	Thread ランタイムサービスが利用できません。

注記

親 Session がアクティブな間、一覧にはアーカイブ済み Thread は含まれません。親 Session がアーカイブ済みの場合は含まれることがあります。
Thread ID が分かっている場合は、Thread 取得エンドポイントで最終状態を確認できます。

Session Thread の一覧

リクエストパラメーター

リクエスト例

レスポンス例

エラー

注記

Session Thread の取得

Thread Event の一覧

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

​リクエスト例

​レスポンス例

​エラー

​注記

Session Thread の取得

Thread Event の一覧

リクエストパラメーター

リクエスト例

レスポンス例

エラー

注記