Lists custom and official Skills with pagination and filters by source and keyword.
Endpoint
GET /api/v1/skills
Lists custom and official Skills with pagination.
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| type | string | — | OFFICIAL or CUSTOMER. Case-sensitive. If omitted, queries both types |
| keywords | string | — | Keyword. Ignored if blank after trimming |
| pageNo | integer | 1 | Page number. Minimum 1 |
| pageSize | integer | 20 | Number of items per page. Valid values: 1 to 100 |
type=OFFICIAL: returns only non-deleted official Skills with theactivestatus.type=CUSTOMER: returns non-deleted custom Skills under the primary account and workspace, includingcheckingandrejectedstatuses.- If
typeis omitted, returns official and custom Skills in one response.totalis the total of both types.
Response
data is a page object. Each item in items is a SkillDTO.
| Field | Type | Description |
|---|---|---|
| items | array<SkillDTO> | Skills on the current page |
| total | long | Total number of matching Skills |
| page_no | integer | Current page number |
| page_size | integer | Number of items per page |
items is an empty array and total is 0.
Example
The list is updated asynchronously. After a Skill is created, deleted, or its status changes, the list may take a moment to reflect the latest state. Use Get a Skill as the source of truth.
Errors
| HTTP status | error_code | Description |
|---|---|---|
| 401 | WORKSPACE_ID_ILLEGAL | Identity information is missing or invalid |
| 400 | INVALID_PARAMETER | type is not OFFICIAL or CUSTOMER, or pageNo or pageSize is not an integer, is out of range, or exceeds the pagination limit |
| 500 | SYSTEM_ERROR | The query failed or an internal error occurred |