Retrieve a Skill - Qoder CN Series - Alibaba Cloud Documentation Center

Request headers

Header	Required	Description
`Authorization`	Yes	Bearer PAT — see `Authorization: Bearer $QODER_PAT`.

Path parameters

Parameter	Type	Required	Description
`skill_id`	string	Yes	Unique Skill identifier, prefixed with `skill_`.

Example request

curl -X GET "https://api.qoder.com.cn/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d" \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
  "type": "skill",
  "name": "my-custom-skill",
  "description": "Custom Skill example",
  "skill_type": "custom",
  "status": "active",
  "version": 1,
  "content_size": 309,
  "content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
  "metadata": {},
  "created_at": "2026-05-18T15:35:24.248164Z",
  "updated_at": "2026-05-18T15:35:24.248164Z"
}

Response fields

Field	Type	Description
`id`	string	Unique Skill identifier, prefixed with `skill_`.
`type`	string	Resource type. Always `"skill"`.
`name`	string	Skill name.
`description`	string	Skill description.
`skill_type`	string	Skill type: `custom` or `prebuilt`.
`status`	string	Skill status. Currently always `active`.
`version`	integer	Current version number, starting at 1.
`content_size`	integer	Zip content size in bytes.
`content_sha256`	string	SHA-256 hash of the zip content.
`metadata`	object	User-defined metadata.
`created_at`	string	Creation timestamp (ISO 8601).
`updated_at`	string	Last-updated timestamp (ISO 8601).

Errors

HTTP	Type	Trigger
401	`authentication_error`	Missing or invalid authentication token.
404	`not_found_error`	Skill does not exist or has been deleted.

For the full error envelope, see Errors.