Gets the metadata and scan status of a Skill version.
Endpoint
GET /api/v1/skills/{skill_id}/versions/{version}
Gets a version. The version number must match exactly. The API does not fall back to the latest version.
For an official Skill, only active versions can be retrieved. Other statuses are treated as nonexistent. Deleted versions are treated as nonexistent.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| skill_id | string | Yes | Skill ID |
| version | string | Yes | Version number, such as 1.0 |
Response
Returns a SkillVersionDTO.
| Field | Type | Description |
|---|---|---|
| id | string | Unique version ID |
| type | string | Always skill_version |
| skill_id | string | ID of the parent Skill |
| display_name | string | Display name of the version |
| display_description | string | Display description of the version |
| version | string | Version number |
| status | string | Version status |
| created_at | string | Creation time |
| updated_at | string | Update time |
| additional_properties | object / null | Additional properties. Contains error_info when the security scan fails |
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 |