Retrieve skill version API: GET /skills/{skill_id}/versions/{version}-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

Returns the metadata and scan status of a specified version.

Prerequisites

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

Endpoint

GET /skills/{skill_id}/versions/{version}

Request example

bash

curl "$AGENTSTUDIO_URL/skills/skill_xxx/versions/1.0" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

python

sv = client.skills.versions.retrieve("skill_xxx", "1.0")
print(sv.version, sv.status)

java

SkillVersion v = client.skills().retrieveVersion("skill_xxx", "1.0");
System.out.println(v.getVersion() + " " + v.getStatus());

Response example

{
  "id": "skillver_xxx",
  "skill_id": "skill_xxx",
  "type": "skill_version",
  "name": "pdf3.0",
  "description": "Description parsed from SKILL.md",
  "version": "1.0",
  "status": "active",
  "created_at": "2026-06-16T07:56:03+00:00",
  "updated_at": "2026-06-16T07:57:42+00:00"
}

Response 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