Skip to main content
Sessions

Session スレッド一覧

managed-agent Session 内のスレッドを一覧表示します。

GET /api/v1/cloud/sessions/{session_id}/threads Session 内のスレッドを取得します。Coordinator スレッドが子スレッドより前に一覧表示されます。

パスパラメータ

パラメータ型説明
session_idstringsess_ プレフィックス付きの Session ID

ヘッダー

ヘッダー必須説明
AuthorizationはいBearer $QODER_PAT

クエリパラメータ

パラメータ型必須説明
limitintegerいいえ返却するスレッドの最大数。デフォルトは 20、範囲は 1〜100。100 を超える値は 400 invalid_request_error を返します。
pagestringいいえ前回のレスポンスの next_page から取得した不透明なカーソル

リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/sessions/sess_019f00000000000000000000000000aa/threads?limit=10" \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK 
{
  "data": [
    {
      "id": "sthr_019f00000000000000000000000001aa",
      "type": "session_thread",
      "session_id": "sess_019f00000000000000000000000000aa",
      "parent_thread_id": null,
      "agent": {"id": "agent_019f000000000000000000000000001a", "type": "agent", "version": 1},
      "status": "idle",
      "stats": null,
      "archived_at": null,
      "created_at": "2026-06-15T08:00:00.000Z",
      "updated_at": "2026-06-15T08:05:00.000Z"
    }
  ],
  "first_id": "sthr_019f00000000000000000000000001aa",
  "has_more": false,
  "last_id": "sthr_019f00000000000000000000000001aa",
  "next_page": null
}

レスポンスフィールド

フィールド型説明
dataarray of Session Threadスレッドオブジェクト
has_morebooleanこのページを超えてさらに結果が利用可能かどうか
first_idstring | null現在のページの最初のスレッドの ID
last_idstring | null現在のページの最後のスレッドの ID
next_pagestring | null次のページの不透明なカーソル

エラー

HTTPtypeトリガー条件
400invalid_request_error無効なページネーションパラメータ
401authentication_errorPAT が無効または期限切れ
404not_found_errorSession が存在しない
HTTP 404 Not Found 
{
  "type": "error",
  "request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
  "error": {
    "type": "not_found_error",
    "message": "Session 'sess_doesnotexist_xxxxxxxxxxxxxxxxxxxxxxxx' was not found."
  }
}
完全なエラーエンベロープリファレンスは エラー を参照してください。

関連項目

Managed Agents

Coordinator と子スレッドの協調モデルを学びます。

Thread をアーカイブ

特定の子スレッドを終了します。

Session Thread オブジェクト

Session Thread オブジェクトの完全なフィールドリファレンス。
はじめに
Agent の定義
Agent 環境の設定
Agent にタスクを委任する
Agent 連携
Agent コンテキストの管理
アカウント
ベストプラクティス
お知らせ
API リファレンス