REST API
Skills
Enabled skills in the workspace — reusable procedures (SKILL.md bundles) an agent can read and follow.
Authorization
bearerAuth AuthorizationBearer <token>
Workspace API key (Settings → API Keys)
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/skills"{
"items": [
{
"name": "string",
"description": "string",
"version": 0,
"source": "uploaded",
"official": true,
"allowedTools": [
"string"
],
"compatibility": "string",
"files": [
{
"path": "string",
"size": 0,
"kind": "markdown"
}
]
}
]
}{
"error": "string"
}{
"error": "string"
}Fetch one file from a skill bundle by its path (e.g. ?path=SKILL.md). Text files are returned inline; binaries as a signed URL.
Authorization
bearerAuth AuthorizationBearer <token>
Workspace API key (Settings → API Keys)
In: header
Path Parameters
name*string
Skill name
Query Parameters
path*string
File path inside the bundle, e.g. SKILL.md
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/skills/string/files?path=SKILL.md"{
"path": "string",
"kind": "markdown",
"size": 0,
"content": "string",
"url": "string"
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}