Skill

Upload a New Skill Version

Upload a new version of a skill package.

POST

/api/v1/agentstudio/skills/{skill_id}/versions

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/skills/{skill_id}/versions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_id": "file_xxx"
}
'

{
  "id": "skillver_xxx",
  "skill_id": "skill_xxx",
  "type": "skill_version",
  "name": "pdf3.0",
  "description": "从 SKILL.md 解析的描述",
  "version": "1.1",
  "status": "checking",
  "created_at": "2026-06-15T08:23:11.456+00:00",
  "updated_at": "2026-06-15T08:23:11.456+00:00"
}

Authorizations

string

header

required

DashScope API Key

Path Parameters

string

required

Body

application/json

string

required

已上传的新版本 zip 包文件 ID

Response

200-application/json

string

版本 ID，格式 skillver_xxx

string

所属技能 ID

string

固定为 skill_version

string

从该版本 zip 包内 SKILL.md 解析得到

string

从该版本 zip 包内 SKILL.md 解析得到

string

版本号，由服务端生成

enum<string>

扫描状态，仅 active 可挂载

Available options:checking,active,rejected

string

创建时间，ISO 8601

string

最近更新时间，ISO 8601

object

仅 status=rejected 时返回，含 error_info：按 zip 包内文件路径列出的安全审查问题

Show child attributes

object

键为 zip 包内文件路径，值为该文件的安全审查问题列表

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/skills/{skill_id}/versions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_id": "file_xxx"
}
'

{
  "id": "skillver_xxx",
  "skill_id": "skill_xxx",
  "type": "skill_version",
  "name": "pdf3.0",
  "description": "从 SKILL.md 解析的描述",
  "version": "1.1",
  "status": "checking",
  "created_at": "2026-06-15T08:23:11.456+00:00",
  "updated_at": "2026-06-15T08:23:11.456+00:00"
}