Lists Skill versions with pagination. Newer versions come first.
Endpoint
GET /api/v1/skills/{skill_id}/versions
Lists Skill versions with pagination. Newer versions come first. For a custom Skill, returns all non-deleted versions, including checking and rejected statuses. For an official Skill, returns only active versions.
Request parameters
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| skill_id | Path | string | Yes | Skill ID |
| pageNo | Query | integer | No | Page number. Default 1. Minimum 1 |
| pageSize | Query | integer | No | Number of items per page. Default 20. Valid values: 1 to 100 |
pageNo × pageSize cannot exceed 10000.
Response
data is a page object. Each item in items is a SkillVersionDTO.
| Field | Type | Description |
|---|---|---|
| items | array<SkillVersionDTO> | Versions on the current page |
| total | long | Total number of versions |
| page_no | integer | Current page number |
| page_size | integer | Number of items per page |
Example
Errors
| HTTP status | error_code | Description |
|---|---|---|
| 401 | WORKSPACE_ID_ILLEGAL | Identity information is missing or invalid |
| 400 | SKILL_ID_IS_NULL | skill_id is blank |
| 400 | INVALID_PARAMETER | pageNo or pageSize is not an integer, is out of range, or exceeds the pagination limit |
| 500 | SKILL_NOT_EXIST | The Skill does not exist, is deleted, or is inaccessible |