Skip to main content
DELETE
/
api
/
v1
/
chatflows
/
{id}
Delete Chatflow
curl --request DELETE \
  --url https://api.example.com/api/v1/chatflows/{id}
{
  "401": {},
  "403": {},
  "404": {},
  "412": {},
  "500": {},
  "message": "<string>",
  "id": "<string>"
}

​
Authentication

This endpoint requires authentication. You must include your API key in the request headers or be authenticated via session.
Required permissions: chatflows:delete or agentflows:delete

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the chatflow to delete

​
Response

Returns a success confirmation message upon successful deletion.
​
message
string
Confirmation message indicating successful deletion
​
id
string
The ID of the deleted chatflow

​
Example Request

cURL
curl -X DELETE "https://your-flowise-instance.com/api/v1/chatflows/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const chatflowId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(`https://your-flowise-instance.com/api/v1/chatflows/${chatflowId}`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const result = await response.json();
Python
import requests

chatflow_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.delete(
    f'https://your-flowise-instance.com/api/v1/chatflows/{chatflow_id}',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
result = response.json()

​
Example Response

{
  "message": "Chatflow deleted successfully",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

​
Error Responses

​
401
error
Unauthorized - Invalid or missing API key
​
403
error
Forbidden - Insufficient permissions to delete this chatflow
​
404
error
Not Found - Chatflow with the specified ID does not exist or is not in your workspace
​
412
error
Precondition Failed - ID parameter was not provided
​
500
error
Internal Server Error - An error occurred while deleting the chatflow

​
What Gets Deleted

When you delete a chatflow, the following associated data is also removed:
  • All chat messages and conversation history
  • Chat message feedback
  • Upsert history records
  • Associated document store entries
  • Uploaded files and storage
  • Rate limiter configurations
This action is irreversible. Once a chatflow is deleted, all associated data is permanently removed and cannot be recovered.
The chatflow must belong to your active workspace. You cannot delete chatflows from other workspaces.
Make sure to update any integrations or applications that reference this chatflow ID before deletion to avoid broken references.

Build docs developers (and LLMs) love

Get started for freeTalk to us