Trillet AI logo

Delete Call Flow

Delete a call flow and its agent, and free its phone numbers.

DELETEhttps://api.trillet.ai/v1/api/call-flows/{id}

Headers

x-workspace-idstringrequired

Workspace identifier for the API.

Path Parameters

idstringrequired

The unique ID of the call flow to delete.

What happens

In one step, the endpoint:

  • marks the call flow as deleted, so it no longer appears in the API or the dashboard;
  • marks the flow's agent as deleted too;
  • unassigns every phone number the flow held. The numbers stay in your workspace (they are not released or cancelled), but their per-flow configuration (recording, office hours, transfer caller ID) is reset, and they take no calls until you assign them to another agent.

The flow and agent are soft-deleted: the records are kept and can be recovered by Trillet support. To take a flow out of service without deleting it, archive it in the dashboard instead.

Errors

StatusBodyWhen
400{"error": "Workspace ID is required."}No x-workspace-id
404{"message": "Flow not found"}No flow with that ID in this workspace
500{"message": "Error deleting flow"}Unexpected server error
HTTP/1.1 204 No Content 

Last updated on