Agent を検索

POST /api/v1/cloud/agents/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	Agent 名の部分一致（大文字と小文字を区別しない）
`include_archived`	boolean	アーカイブ済み Agent を含める
`created_at[gte]`	string	RFC 3339 形式の作成日時の下限（含む）
`created_at[lte]`	string	RFC 3339 形式の作成日時の上限（含む）

curl -X POST "https://api.qoder.com/api/v1/cloud/agents/search" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-qoder-beta: search-2026-08-31" \
  -d '{"metadata":{"team":"core"},"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 のリソースフィールドはAgent 一覧と同じです。metadata の key は 1〜64 文字、value は最大 512 文字の文字列です。呼び出し元ごとのデフォルトの処理中リクエスト上限は 10 で、超過すると 429 rate_limit_error が返されます。

​レスポンス

レスポンス