メインコンテンツへスキップ
GET /v1/sessions 現在のアカウント配下の Session 一覧を取得します。カーソルページネーションをサポートします。アーカイブ済み Session はデフォルトで除外されます。結果はデフォルトで Session ID の降順でソートされ、生成される ID では新しい順に相当します。

​
ヘッダー

名称必須値
AuthorizationはいBearer $QODER_PAT

​
クエリパラメータ

パラメータ型必須説明
limitintegerいいえ返却件数の上限、デフォルト 20
after_idstringいいえカーソルページネーション：この ID 以降のレコードを返す
before_idstringいいえカーソルページネーション：この ID 以前のレコードを返す
orderstringいいえソート方向：desc（デフォルト）または asc
include_archivedbooleanいいえtrue を設定するとアーカイブ済み Session を含む
statuses[]stringいいえ1 つ以上の Session ライフサイクル状態でフィルタリング。複数値の場合はパラメータを繰り返します。
agent_idstringいいえAgent ID で Session をフィルタリング
agent_versionintegerいいえAgent バージョンで Session をフィルタリング。0 または省略時はフィルタリングしません。
environment_idstringいいえEnvironment ID で Session をフィルタリング
created_at[gt]stringいいえこの RFC 3339 タイムスタンプより後に作成されたレコードを返す
created_at[gte]stringいいえこの RFC 3339 タイムスタンプ以降に作成されたレコードを返す
created_at[lt]stringいいえこの RFC 3339 タイムスタンプより前に作成されたレコードを返す
created_at[lte]stringいいえこの RFC 3339 タイムスタンプ以前に作成されたレコードを返す

​
リクエスト例

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

# Agent でフィルタリングし、アーカイブ済みも含める
curl -X GET "https://api.qoder.com/api/v1/cloud/sessions?agent_id=agent_xxx&include_archived=true" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "data": [
    {
      "id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
      "type": "session",
      "agent_id": "agent_019e390add9f7bac9b6cc806db46fcbd",
      "agent": { "..." },
      "environment_id": "env_019e2590d33f711fabf42f2857cecd8a",
      "title": "API-doc-verification-session",
      "status": "idle",
      "turn_status": "idle",
      "metadata": {},
      "resources": [],
      "vault_ids": [],
      "memory_store_ids": [],
      "environment_variables": {},
      "stats": { "active_seconds": 0, "duration_seconds": 0 },
      "archived_at": null,
      "created_at": "2026-05-18T15:26:15.747298Z",
      "updated_at": "2026-05-18T15:26:15.747298Z"
    }
  ],
  "first_id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
  "last_id": "sess_019e259100f573c08b0b20005cce9828",
  "has_more": false
}

​
ページネーションフィールド

フィールド型説明
dataarraySession オブジェクトの配列
first_idstring現在ページ先頭レコードの ID
last_idstring現在ページ末尾レコードの ID
has_morebooleanさらにレコードがあるかどうか
last_id を次回リクエストの after_id パラメータとして使用すると、後方ページネーションを実現できます。

​
エラーレスポンス

HTTPtype説明
401authentication_errorPAT が無効または期限切れ

​
関連項目

Session の起動

Agent を環境で実行し、ステートフルな対話を行う。