Search sessions - Qoder CN

POST /api/v1/cloud/sessions/search Requires x-qoder-beta: search-2026-08-31. All parameters are optional and belong 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 Session title substring match
`order`	string	`desc` (default) or `asc`
`include_archived`	boolean	Include archived Sessions
`statuses`	array<string>	`running`, `idle`, `rescheduling`, or `terminated`
`agent_id`	string	Filter by Agent ID
`agent_version`	integer	Filter by Agent version
`deployment_id`	string	Filter by Deployment ID
`memory_store_id`	string	Filter by mounted Memory Store ID
`created_at[gt]`, `created_at[gte]`	string	Exclusive/inclusive RFC 3339 lower bound
`created_at[lt]`, `created_at[lte]`	string	Exclusive/inclusive RFC 3339 upper bound

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

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 sessions. Metadata keys are 1–64 characters and values are strings up to 512 characters. The default in-flight limit is 10; excess requests return 429 rate_limit_error.

​Response

Response