Get a skill version

GET /api/v1/cloud/skills/{skill_id}/versions/{version} Retrieves the details of a single skill version by its version identifier.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or SAT>`

Path parameters

Parameter	Type	Required	Description
`skill_id`	string	Yes	Skill unique identifier
`version`	string	Yes	Version number; numeric timestamps only

Example request

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

Example response

HTTP 200 OK

{
  "id": "skillver_019e3bba474b7f10a3c2b4d5e6f70123",
  "type": "skill_version",
  "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
  "version": "1759178010641129",
  "name": "my-custom-skill",
  "description": "Custom skill example",
  "directory": "my-custom-skill",
  "created_at": "2026-05-18T15:35:24.248164Z"
}

Response fields

The response is a Skill version object.

Field	Type	Description
`id`	string	Version unique identifier
`type`	string	Always `"skill_version"`
`skill_id`	string	Owning Skill ID
`version`	string	Version identifier
`name`	string	`name` from this version's `SKILL.md` frontmatter
`description`	string	`description` from this version's `SKILL.md` frontmatter
`directory`	string	Skill directory name
`created_at`	string	Version creation time

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	Non-numeric version (including `latest`)
401	`TOKEN_INVALID`	Missing or invalid authentication token
404	`not_found_error`	Skill does not exist, or the version does not exist / has been deleted

See Errors for the full error envelope.

Agent Skills

Attach domain expertise to your agent.

​Headers

​Path parameters

​Example request

​Example response

​Response fields

​Errors

​Related