List Skill Versions

Prerequisites

Endpoint and authentication configured. For details, see Overview and authentication.

Endpoint

GET /skills/{skill_id}/versions Returns versions in descending order by version number. Each item contains version, status, and created_at.

Query parameters

Parameter	Required	Type	Default	Description
`limit`	No	int	20	Number of items per page, maximum 100
`page`	No	string	—	Omit on the first call; pass `next_page` from the previous response for subsequent calls

Request example

curl "$AGENTSTUDIO_URL/skills/skill_xxx/versions?limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "data": [
    {
      "id": "skillver_xxx",
      "skill_id": "skill_xxx",
      "type": "skill_version",
      "name": "pdf3.0",
      "description": "Description parsed from SKILL.md",
      "version": "1.1",
      "status": "active",
      "created_at": "2026-06-16T08:12:47+00:00",
      "updated_at": "2026-06-16T08:14:30+00:00"
    },
    {
      "id": "skillver_xxx",
      "skill_id": "skill_xxx",
      "type": "skill_version",
      "name": "pdf3.0",
      "description": "Description parsed from SKILL.md",
      "version": "1.0",
      "status": "rejected",
      "created_at": "2026-06-16T07:56:03+00:00",
      "updated_at": "2026-06-16T07:57:42+00:00",
      "additional_properties": {
        "error_info": {
          "/index.js": "[Dangerous Tools Without Confirmation] Line 179: ...",
          "/SKILL.md": "[Dangerous Tools Without Confirmation] Line 10: ..."
        }
      }
    }
  ],
  "next_page": "xxx",
  "request_id": "xxx"
}

The response contains data (an array of Skill Version objects) and next_page. Skill Version object fields are as follows:

Skill Version object fields

Field	Type	Description
`id`	string	Version ID, format: `skillver_xxx`
`skill_id`	string	Parent skill ID
`type`	string	Always `skill_version`
`name` / `description`	string	Parsed from `SKILL.md` inside this version's zip
`version`	string	Version number, generated by the server
`status`	string	Scan status: `checking` / `active` / `rejected`. Only `active` can be mounted
`created_at` / `updated_at`	string	Creation / last update time, ISO 8601
`additional_properties`	object	Returned only when `status=rejected`; contains `error_info`: security review issues listed by file path within the zip

​Prerequisites

​Endpoint

​Query parameters

​Request example

​Response example