List Skills
Returns the custom skills installed (and/or enabled) in the workspace associated with your API key. Use this to surface agent-capable skills in your UI, or to let downstream clients decide whether a skill is available before orchestrating a run.
API key authentication is required. Only skills in the API key’s workspace are returned, and internal identifiers such as storagePath are never exposed.
Request
| Header | Required | Description |
|---|
Authorization | Yes | Bearer snorbe_... API key |
The workspace is inferred from the API key. No query parameters or body required.
Response
[
{
"id": "cl123abc",
"name": "Patent Search",
"description": "Patent search workflow for semiconductor domain",
"enabled": true,
"isOfficial": false
},
{
"id": "cl456def",
"name": "Snorbe API",
"description": "Invoke Snorbe REST API from inside an agent",
"enabled": true,
"isOfficial": true
}
]
Response fields
| Field | Type | Description |
|---|
id | string | Skill ID |
name | string | Skill display name |
description | string | Skill description |
enabled | boolean | Whether the skill is enabled in the workspace |
isOfficial | boolean | Whether the skill came from the Snorbe official catalog (e.g. installed via npx skills add deskrexai/snorbe) |
Internal identifiers such as storagePath and owner user IDs are intentionally omitted.
Examples
curl "https://app.snorbe.deskrex.ai/api/v1/skill/list" \
-H "Authorization: Bearer snorbe_your_api_key_here"
Error responses
| HTTP status | Code | Description |
|---|
| 401 | UNAUTHORIZED | API key missing, invalid, or expired |
| 429 | TOO_MANY_REQUESTS | Rate limit exceeded |
