Search skills - Qoder CN

POST /api/v1/cloud/skills/search Requires x-qoder-beta: search-2026-08-31. All optional parameters are JSON body fields; 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`
`source`	string	`custom` or `qoder`
`display_title`	string	Case-insensitive display-title substring match
`name`	string	Deprecated alias of `display_title`

curl -X POST "https://api.qoder.com.cn/api/v1/cloud/skills/search" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" -H "Content-Type: application/json" \
  -H "x-qoder-beta: search-2026-08-31" \
  -d '{"metadata":{"team":"core","environment":"test"},"source":"custom","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 skills. 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