List skill versions

GET /api/v1/cloud/skills/{skill_id}/versions Returns the paginated list of all versions of the specified skill, ordered by version descending (newest first).

Path parameters

Parameter	Type	Required	Description
`skill_id`	string	Yes	Skill unique identifier

Headers

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

Query parameters

Parameter	Type	Required	Description
`limit`	integer	No	Maximum number of records per page. Default 20, maximum 1000
`page`	string	No	Forward cursor; pass the `next_page` value from the previous response

Example request

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

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "skillver_019e3bbb6a25768b9b50ca2f52aa4345",
      "type": "skill_version",
      "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
      "version": "1759264410332875",
      "name": "my-custom-skill",
      "description": "Custom skill example (second revision)",
      "directory": "my-custom-skill",
      "created_at": "2026-05-19T10:12:07.332875Z"
    },
    {
      "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"
    }
  ],
  "has_more": false,
  "next_page": null
}

Response fields

Field	Type	Description
`data`	array	Array of Skill version objects, ordered by `version` descending
`has_more`	boolean	Whether more records are available; when `true`, use `next_page` as the next page's `page` value
`next_page`	string \| null	Forward cursor for the next page; pass as `page` when `has_more` is `true`

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
`content_size`	integer	⚠️ Deprecated: size of the version's zip content in bytes (no replacement; will be removed)
`content_sha256`	string	⚠️ Deprecated: SHA-256 hash of the version's content (no replacement; will be removed)
`status`	string	⚠️ Deprecated: version status `active` (no replacement; will be removed)
`updated_at`	string	⚠️ Deprecated: version last-update time (versions are immutable; use `created_at` instead)

Errors

HTTP	Type	Trigger
401	`TOKEN_INVALID`	Missing or invalid authentication token
404	`not_found_error`	Skill does not exist or is no longer accessible

Notes

Each version is an immutable, complete content snapshot appended via Create a skill version.

See Errors for the full error envelope.

Agent Skills

Attach domain expertise to your agent.

​Path parameters

​Headers

​Query parameters

​Example request

​Example response

​Response fields

​Errors

​Notes

​Related