Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.snorbe.deskrex.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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

GET /api/v1/skill/list

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer 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

FieldTypeDescription
idstringSkill ID
namestringSkill display name
descriptionstringSkill description
enabledbooleanWhether the skill is enabled in the workspace
isOfficialbooleanWhether 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 statusCodeDescription
401UNAUTHORIZEDAPI key missing, invalid, or expired
429TOO_MANY_REQUESTSRate limit exceeded