Session を検索

POST /api/v1/cloud/sessions/search x-qoder-beta: search-2026-08-31 が必要です。すべてのパラメーターは任意で、JSON Body に指定します。URL Query パラメーターは無視されます。

パラメーター	型	説明
`metadata`	object<string,string>	metadata の完全一致条件。複数の条件は AND で結合
`limit`	integer	ページサイズ
`page`	string	`next_page` で返されるカーソル
`name`	string	Session タイトルの部分一致（大文字と小文字を区別しない）
`order`	string	`desc`（デフォルト）または `asc`
`include_archived`	boolean	アーカイブ済み Session を含める
`statuses`	array<string>	`running`、`idle`、`rescheduling`、または `terminated`
`agent_id`	string	Agent ID で絞り込む
`agent_version`	integer	Agent バージョンで絞り込む
`deployment_id`	string	Deployment ID で絞り込む
`memory_store_id`	string	マウントされた Memory Store ID で絞り込む
`created_at[gt]`, `created_at[gte]`	string	RFC 3339 形式の下限（排他/包含）
`created_at[lt]`, `created_at[lte]`	string	RFC 3339 形式の上限（排他/包含）

curl -X POST "https://api.qoder.com/api/v1/cloud/sessions/search" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" -H "Content-Type: application/json" \
  -H "x-qoder-beta: search-2026-08-31" \
  -d '{"metadata":{"ticket":"A-123"},"statuses":["idle"],"limit":20}'

レスポンス

フィールド	型	説明
`data`	array	現在のページのリソース。各リソースのフィールドは対応する List エンドポイントを参照
`first_id`	string \| null	現在のページの最初のリソース ID
`last_id`	string \| null	現在のページの最後のリソース ID
`has_more`	boolean	次のページがあるかどうか
`next_page`	string \| null	次のページのカーソル。次のページがない場合は `null`
`total`	integer \| null	最初のページではフィルターに一致するリソース総数。`page` 使用時は `null`

{
  "data": [],
  "first_id": null,
  "has_more": false,
  "last_id": null,
  "next_page": null,
  "total": 0
}

data のリソースフィールドはSession 一覧と同じです。metadata の key は 1〜64 文字、value は最大 512 文字の文字列です。デフォルトの処理中リクエスト上限は 10 で、超過すると 429 rate_limit_error が返されます。

​レスポンス

レスポンス