Skip to main content

Get version details

Gets the metadata and scan status of a Skill version.

Endpoint

GET /api/v1/skills/{skill_id}/versions/{version} Gets a version. The version number must match exactly. The API does not fall back to the latest version. For an official Skill, only active versions can be retrieved. Other statuses are treated as nonexistent. Deleted versions are treated as nonexistent.

Request parameters

ParameterTypeRequiredDescription
skill_idstringYesSkill ID
versionstringYesVersion number, such as 1.0

Response

Returns a SkillVersionDTO.
FieldTypeDescription
idstringUnique version ID
typestringAlways skill_version
skill_idstringID of the parent Skill
display_namestringDisplay name of the version
display_descriptionstringDisplay description of the version
versionstringVersion number
statusstringVersion status
created_atstringCreation time
updated_atstringUpdate time
additional_propertiesobject / nullAdditional properties. Contains error_info when the security scan fails

Example

curl "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/skills/skill_abc123/versions/1.0" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "success": true,
  "error_code": null,
  "error_msg": null,
  "data": {
    "id": "skillver_xxxxxxxxxxxxxxxxxxxxxx",
    "type": "skill_version",
    "skill_id": "skill_abc123",
    "display_name": "My Custom Skill",
    "display_description": "Description parsed from SKILL.md",
    "version": "1.0",
    "status": "checking",
    "created_at": "2026-06-15T08:23:11Z",
    "updated_at": "2026-06-15T08:23:11Z",
    "additional_properties": null
  },
  "request_id": "15a89d4c-f142-4e00-a9f7-b088442417c9"
}

Errors

HTTP statuserror_codeDescription
401WORKSPACE_ID_ILLEGALIdentity information is missing or invalid
400SKILL_ID_IS_NULLskill_id is blank
400SKILL_VERSION_IS_NULLversion is blank
500SKILL_NOT_EXISTThe Skill does not exist, is deleted, or is inaccessible
500SKILL_VERSION_NOT_EXISTThe version does not exist, is deleted, or is a non-active version of an official Skill