ApiWorkflows

Delete a workflow

DELETE
/workflows/{id}

Delete a workflow. Deletion is refused with HTTP 409 while phone numbers still run this workflow - detach them first with PATCH /numbers/{id} and workflow_id: null - so live numbers never change behaviour as a side effect.

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Get your key from the dashboard.

In: header

Path Parameters

id*string

Workflow UUID

Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "success": true
}
{
  "error": "Invalid API key",
  "message": "string"
}
{
  "error": "Invalid API key",
  "message": "string"
}
{
  "error": "Workflow is attached to 2 phone numbers. Detach it first (PATCH /numbers/{id} with workflow_id: null)."
}

Update a workflow PATCH

Update a workflow's name, definition or active state. A new definition replaces the old one entirely and is validated the same way as on create. Changes apply to the next call; calls already in progress finish on the definition they started with.

List calls GET

Retrieve call history with optional filtering by status and date range. Returns complete call data including transcripts, analysis results, and metadata.