Gets a temporary download URL for a Skill version ZIP package. The URL is valid for 2 hours.
Endpoint
GET /api/v1/skills/{skill_id}/versions/{version}/content
Returns a temporary download URL for the version ZIP package. The API does not return the ZIP binary stream. The version number must match exactly. The API does not fall back to the latest version.
For a custom Skill, all non-deleted versions can be downloaded, including checking and rejected statuses. For an official Skill, only active versions can be downloaded.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| skill_id | string | Yes | Skill ID |
| version | string | Yes | Version number, such as 1.0 |
Response
Returns a VersionDownloadResponse.
| Field | Type | Description |
|---|---|---|
| skill_id | string | Skill ID |
| version | string | Version number |
| file_url | string | Presigned download URL for the ZIP package. Valid for 2 hours |
The download URL is generated for each request. When it expires, call this API again to get a new URL.
Example
Errors
| HTTP status | error_code | Description |
|---|---|---|
| 401 | WORKSPACE_ID_ILLEGAL | Identity information is missing or invalid |
| 400 | SKILL_ID_IS_NULL | skill_id is blank |
| 400 | SKILL_VERSION_IS_NULL | version is blank |
| 500 | SKILL_NOT_EXIST | The Skill does not exist, is deleted, or is inaccessible |
| 500 | SKILL_VERSION_NOT_EXIST | The version does not exist, is deleted, or is a non-active version of an official Skill |
| 500 | SYSTEM_ERROR | Failed to generate the download URL |