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

Returns skill metadata and the latest version number. The response structure is the same as Create Skill.

Prerequisites

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

Endpoint

GET /skills/{skill_id}

Request example

Bash

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

Python

skill = client.skills.retrieve("skill_xxx")
print(skill.name, skill.latest_version)

Java

Skill s = client.skills().retrieve("skill_xxx");
System.out.println(s.getName() + " " + s.getLatestVersion());

Response example

{
  "id": "skill_xxx",
  "type": "skill",
  "name": "pdf3.0",
  "description": "Use this skill whenever the user wants to do anything with PDF files...",
  "source": "customer",
  "status": "active",
  "latest_version": "1.1",
  "created_at": "2026-06-16T07:56:03Z",
  "updated_at": "2026-06-16T08:12:47Z",
  "request_id": "xxx"
}

Response fields

Field	Type	Description
`id`	string	Skill ID, format: `skill_xxx`
`type`	string	Fixed value `skill`
`name` / `description`	string	Parsed from `SKILL.md` inside the zip
`source`	string	Source: `customer` (self-built) / `official` (Model Studio official)
`status`	string	Scan status: `checking` / `active` / `rejected` / `deleted`. Only `active` can be mounted
`latest_version`	string	Latest version number. When mounting to an agent, do not lock to `latest`; you must specify a concrete version
`created_at` / `updated_at`	string	Creation / last update time, ISO 8601
`request_id`	string	Unique identifier for this request