Search agents - Qoder CN

POST /api/v1/cloud/agents/search Requires x-qoder-beta: search-2026-08-31. All parameters are optional and must be sent in the JSON body. URL query parameters are ignored.

Parameter	Type	Description
`metadata`	object<string,string>	Exact metadata pairs combined with AND
`limit`	integer	Page size
`page`	string	Cursor returned in `next_page`
`name`	string	Case-insensitive Agent name substring match
`include_archived`	boolean	Include archived Agents
`created_at[gte]`	string	Inclusive RFC 3339 creation-time lower bound
`created_at[lte]`	string	Inclusive RFC 3339 creation-time upper bound

curl -X POST "https://api.qoder.com.cn/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}'

Response

Field	Type	Description
`data`	array	Resources in the current page; see the corresponding List endpoint for resource fields
`first_id`	string \| null	First resource ID in the current page
`last_id`	string \| null	Last resource ID in the current page
`has_more`	boolean	Whether another page is available
`next_page`	string \| null	Cursor for the next page, or `null` when there is no next page
`total`	integer \| null	Total resources matching the filters on the first page; `null` when `page` is used

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

Resource fields in data match List agents. Metadata keys are 1–64 characters and values are strings up to 512 characters. The default per-caller in-flight limit is 10; excess requests return 429 rate_limit_error.

​Response

Response