Gets the metadata and latest version number of a Skill.
Endpoint
GET /api/v1/skills/{skill_id}
Gets a Skill. For a custom Skill, returns the non-deleted record under the primary account and workspace, including checking and rejected statuses. For an official Skill, returns only the active status.
This API does not return the version list or download URL.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| skill_id | string | Yes | Skill ID |
Response
Returns a SkillDTO.
| Field | Type | Description |
|---|---|---|
| id | string | Unique Skill ID |
| display_name | string | Display name |
| display_description | string | Display description |
| source | string | customer or official |
| status | string | Skill status |
| latest_version | string | Latest version number |
| classification | string / null | Classification. Set for official Skills; null for custom Skills |
| meta_info | object / null | Metadata for official Skills; null for custom Skills |
| created_at | string | Creation time |
| updated_at | string | Update time |
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 |
| 500 | SKILL_NOT_EXIST | The Skill does not exist, is deleted, is inaccessible, or the official Skill is not available |