Skip to main content

List versions

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

ParameterLocationTypeRequiredDescription
skill_idPathstringYesSkill ID
pageNoQueryintegerNoPage number. Default 1. Minimum 1
pageSizeQueryintegerNoNumber 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.
FieldTypeDescription
itemsarray<SkillVersionDTO>Versions on the current page
totallongTotal number of versions
page_nointegerCurrent page number
page_sizeintegerNumber of items per page

Example

curl "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/skills/skill_abc123/versions?pageNo=1&pageSize=10" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "success": true,
  "error_code": null,
  "error_msg": null,
  "data": {
    "items": [
      {
        "id": "skillver_NWQ3YmQ1OTRjNGFmxxxxxx",
        "type": "skill_version",
        "skill_id": "skill_abc123",
        "display_name": "workflow-automation",
        "display_description": "Chains multiple skills into an automated workflow",
        "version": "1.0",
        "status": "rejected",
        "created_at": "2026-05-11T09:25:43Z",
        "updated_at": "2026-05-11T09:31:01Z",
        "additional_properties": {
          "error_info": {
            "/index.js": "[Dangerous Tools Without Confirmation] Line 179: ...",
            "/SKILL.md": "[Dangerous Tools Without Confirmation] Line 10: ..."
          }
        }
      }
    ],
    "total": 1,
    "page_no": 1,
    "page_size": 10
  },
  "request_id": "28e054b1-2cc4-4e0f-bac5-0c1395b1d7ae"
}

Errors

HTTP statuserror_codeDescription
401WORKSPACE_ID_ILLEGALIdentity information is missing or invalid
400SKILL_ID_IS_NULLskill_id is blank
400INVALID_PARAMETERpageNo or pageSize is not an integer, is out of range, or exceeds the pagination limit
500SKILL_NOT_EXISTThe Skill does not exist, is deleted, or is inaccessible