Download Skill Version Content

Description

Streams the complete zip package for a specified Skill version. The response body is application/zip; clients should write the body directly to a file instead of attempting to deserialize it.

Path

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

Request headers

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

Path parameters

Parameter	Type	Required	Description
`id`	string	Yes	Skill ID.
`version`	string	Yes	Version number. Accepts a 16-digit Unix microsecond timestamp or a legacy incremental counter during migration. The literal `latest` is not supported and returns 400. See Legacy version-number compatibility.

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.

Example request

curl -sSL -X GET "https://api.qoder.com.cn/api/v1/forward/skills/skill_xxx/versions/1786973491821648/content" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -o customer-reply.zip

Response

HTTP 200 OK The response body is the complete zip archive byte stream.

Response header	Example	Description
`Content-Type`	`application/zip`	Fixed value
`Content-Disposition`	`attachment; filename="customer-reply.zip"`	Suggested download filename, taken from `directory` in the Skill version object, which equals the Skill's `name`.
`Content-Length`	`2607`	Matches `content_size` in the Skill version object.

The zip archive's top-level directory matches directory in the Skill version object. For example:

customer-reply/
├── SKILL
├── scripts/
│   └── run.sh
└── data/
    └── rules.json

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	The version format is invalid, such as `latest` or a nonnumeric string, 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 or version 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

​Response

​Errors