Skip to main content
GET
/
api
/
v1
/
tenants
/
{tenantId}
/
skills
List skills
curl --request GET \
  --url https://api.example.com/api/v1/tenants/{tenantId}/skills \
  --header 'Authorization: <authorization>'

​
Overview

Returns all custom skills registered for your tenant. Skills are tools that AI agents can invoke during investigations.
Skills use a non-standard base path: /api/v1/tenants/{tenantId}/skills — not /v1/. This is a dedicated module with its own routing prefix.
Required role: admin or member

​
Request headers

​
Authorization
string
required
JWT Bearer token. Format: Bearer <your-jwt>.

​
Path parameters

​
tenantId
string
required
Your tenant identifier. Example: ten_EXAMPLE_ABC123.

​
Query parameters

​
enabled
boolean
Filter by enabled/disabled status.
​
type
string
Filter by skill type. One of: http, integration, builtin.

​
Response

Returns 200 OK. 
{
  "items": [
    {
      "skillId": "skl_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "name": "fetch_runbook",
      "description": "Fetches the runbook for a given service from the internal wiki",
      "type": "http",
      "enabled": true,
      "createdAt": "2024-04-01T10:00:00Z",
      "updatedAt": "2024-04-01T10:00:00Z"
    }
  ],
  "total": 1
}

​
Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks required role

​
Examples

curl "https://api.causeflow.ai/api/v1/tenants/ten_EXAMPLE_ABC123/skills?enabled=true" \
  -H "Authorization: Bearer eyJhbGc..."

Create skill

Register a new custom skill

Get skill

Retrieve a single skill by ID