Conversation Flows API

{
  "id": 42,
  "organization_id": 1,
  "base_assistant_id": 123,
  "name": "Customer Support Flow",
  "graph": {
    "begin_node": "start",
    "global_prompt": "Be concise.",
    "nodes": {
      "start": {
        "type": "conversation",
        "prompt": "Greet the caller.",
        "transitions": [
          {
            "kind": "prompt",
            "to": "support",
            "when": "The caller needs support."
          }
        ]
      },
      "support": {
        "type": "conversation",
        "prompt": "Help the caller with support questions."
      }
    }
  },
  "is_active": true,
  "created_at": "2026-04-29T14:00:00Z",
  "updated_at": "2026-04-29T14:00:00Z"
}

curl "https://api.burki.dev/api/v1/flows?active_only=true" \
  -H "Authorization: Bearer $BURKI_API_KEY"

{
  "name": "Customer Support Flow",
  "base_assistant_id": 123,
  "graph": {
    "begin_node": "start",
    "nodes": {
      "start": {
        "type": "conversation",
        "prompt": "Greet the caller and ask how you can help."
      }
    }
  },
  "is_active": true
}

curl https://api.burki.dev/api/v1/flows/42 \
  -H "Authorization: Bearer $BURKI_API_KEY"

curl -X PUT https://api.burki.dev/api/v1/flows/42 \
  -H "Authorization: Bearer $BURKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_active": false}'

curl -X POST https://api.burki.dev/api/v1/flows/42/phone-numbers/7/assign \
  -H "Authorization: Bearer $BURKI_API_KEY"

curl -X POST https://api.burki.dev/api/v1/flows/42/phone-numbers/7/unassign \
  -H "Authorization: Bearer $BURKI_API_KEY"