List Skill Versions

Description

Lists all versions of the specified Skill in descending created_at order, with cursor pagination. Versions are immutable after creation.

Path

GET /api/v1/forward/skills/{id}/versions

Request headers

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

Path parameters

Parameter	Type	Required	Description
`id`	string	Yes	Skill ID.

Query parameters

Parameter	Type	Required	Description
`identity_id`	string	No	Use only when operating on Identity-owned resources. A PAT can explicitly supply this query parameter; omitting it uses administrator scope. SAT ownership is determined by the credential. Explicitly supplying this parameter with any SAT (including an empty value) returns HTTP 400. Versions inherit the ownership of their Skill. See Identity ownership.
`limit`	integer	No	Page size, up to 100; defaults to 20.
`page`	string	No	Forward pagination cursor from `next_page` in the previous response. Omit it to start from the first page.

Example request

curl -X GET "https://api.qoder.com.cn/api/v1/forward/skills/skill_xxx/versions?limit=10" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "skillver_xxx",
      "skill_id": "skill_xxx",
      "version": "1786973491821648",
      "name": "customer-reply",
      "description": "Customer reply skill",
      "directory": "customer-reply",
      "content_size": 2607,
      "content_sha256": "9de8ae3a296bc6198cd080f5ce31d523a34fd0a52e2e64365055fa79a0d3383d",
      "status": "active",
      "created_at": "2026-08-17T13:31:31.917881Z",
      "metadata": {}
    }
  ],
  "has_more": false
}

Response fields

Each item in the response data array is a Skill version object. See Skill version list pagination fields for has_more and next_page.

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	The `limit` or `page` parameter is invalid, or any SAT explicitly supplies the query parameter `identity_id` (including an empty value).
401	`authentication_error`	The authentication token is missing or invalid.
403	`permission_error`	An Owner mismatch occurs in administrator scope, or a downstream service denies access.
404	`not_found_error`	The Skill does not exist or is not visible in the current Identity scope; the Identity specified by the PAT is invalid, disabled, deleted, or outside the caller's authorized scope.
500/502/503	`api_error`	Forward or a dependent service failed.

​Description

​Path

​Request headers

​Path parameters

​Query parameters

​Example request

​Example response

​Response fields

​Errors