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

​
Overview

Returns the full configuration for a single skill, including its input schema and execution config.
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.
​
skillId
string
required
The skill identifier. Example: skl_01HX9VTPQR3KF8MZWBYD5N6JCE.

​
Response

Returns 200 OK with the full skill object. 
{
  "skillId": "skl_01HX9VTPQR3KF8MZWBYD5N6JCE",
  "tenantId": "ten_EXAMPLE_ABC123",
  "name": "fetch_runbook",
  "description": "Fetches the runbook for a given service from the internal wiki",
  "type": "http",
  "config": {
    "url": "https://wiki.example.com/api/runbooks/{service}",
    "method": "GET",
    "headers": { "Authorization": "Bearer {{WIKI_TOKEN}}" }
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "service": { "type": "string" }
    },
    "required": ["service"]
  },
  "enabled": true,
  "createdAt": "2024-04-01T10:00:00Z",
  "updatedAt": "2024-04-01T10:00:00Z"
}

​
Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks required role
404skill_not_foundNo skill with the given ID

​
Examples

curl https://api.causeflow.ai/api/v1/tenants/ten_EXAMPLE_ABC123/skills/skl_01HX9VTPQR3KF8MZWBYD5N6JCE \
  -H "Authorization: Bearer eyJhbGc..."

Update skill

Modify this skill’s configuration

Delete skill

Remove this skill from your tenant