GET /v2/skills/{skill_id}
Retrieve the latest published skill and its public file manifest.
How to use
Read the current published instructions and public file manifest. Latest can change; use the version endpoint for an integration pinned to reviewed instructions.
Authentication and permissions
Required permissions: skills.read. Resource and owner access checks also apply.
Personal API key (sk_...) or supported user access JWT. See Authentication and authorization for endpoint restrictions and scopes. Use exactly one Authorization header.
ID of the skill.
Successful Response
Machine-readable response code, when provided.
Invalid request parameters
Authentication required
Permission denied; insufficient API-key scope includes meta.required_scope
Skill or version not found
Other client errors use the same public error envelope
curl --fail-with-body -sS \
"$STACKAI_BASE_URL/v2/skills/${SKILL_ID}" \
-H "Authorization: Bearer $STACKAI_API_KEY"{
"response_code": "text",
"meta": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"data": {
"skill_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"description": "text",
"version": 1,
"is_builtin": true,
"actions": [
"text"
],
"created_by_user_profile": {
"id": "text",
"full_name": "text"
},
"created_by_org": {
"org_id": "text",
"org_name": "text"
},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"instructions": "text",
"frontmatter": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"files": [
{
"path": "text",
"content_type": "text",
"size": 1
}
]
}
}Last updated
Was this helpful?

