Retrieve a single skill by ID.
GET /api/v1/cloud/skills/{skill_id}
Retrieves the details of a single skill by ID.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
skill_id | string | Yes | Skill unique identifier |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
include_content | boolean | No | ⚠️ Deprecated: set to true to include base64-encoded skill content in content (use Download skill version content GET /skills/{skill_id}/versions/{version}/content instead) |
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Example request
Example response
HTTP 200 OK
Response fields
The response is a Skill object.
| Field | Type | Description |
|---|---|---|
id | string | Skill unique identifier with the skill_ prefix |
type | string | Always "skill" |
display_title | string | Display title |
source | string | Skill source: custom or qoder |
latest_version | string | null | Latest version identifier; null when all versions have been deleted |
metadata | object | Custom metadata object stored with the Skill; defaults to {} |
description | string | ⚠️ Deprecated: skill description (use the description on version objects instead; see Get a skill version) |
content | string | ⚠️ Deprecated: base64-encoded content, present only when include_content=true (use Download skill version content instead) |
content_encoding | string | ⚠️ Deprecated: present with content; value is "base64" (same replacement as above) |
created_at | string | Creation time |
updated_at | string | Last update time |
Errors
| HTTP | Type | Trigger |
|---|---|---|
| 401 | TOKEN_INVALID | Missing or invalid authentication token |
| 404 | not_found_error | Skill does not exist or is no longer accessible |