Skills

Skills are the programmable flows your assistant can run. Push definitions from your own tooling or CI.

Base URLhttps://api.jawbly.com/v1

GET/skills

List skills

List the skills configured for an assistant.

Requires scope skills:read

curl -X GET "https://api.jawbly.com/v1/skills" \
  -H "Authorization: Bearer jwb_live_xxxxxxxxxxxxxxxxxxxxxxxx"

200 response

{
  "data": [
    {
      "id": "sk_9d…",
      "name": "Take order",
      "enabled": true
    }
  ],
  "nextCursor": null
}

PUT/skills/{skillId}

Upsert a skill

Create or replace a skill definition (nodes + edges). Skills are stored data the engine interprets, so this is a plain JSON document.

Requires scope skills:write

Parameters

skillIdrequired

string · path

The skill to create or replace.

curl -X PUT "https://api.jawbly.com/v1/skills/{skillId}" \
  -H "Authorization: Bearer jwb_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Take order",
    "enabled": true,
    "graph": {
      "nodes": [],
      "edges": []
    }
  }'

200 response

{
  "id": "sk_9d…",
  "name": "Take order",
  "enabled": true
}

Assistants Catalog