DELETE/conversations/{conversation_id}

Delete Conversation

Available for: Chatflow, Agent, Chatbot, Legacy Agent apps.

Deletes a conversation.

1 parameter · 1 body field
conversation_idstringrequired
ID of the conversation to delete. Get conversation IDs from [List Conversations](/en/api-reference/conversations/list-conversations).

A JSON body is always required, even when user is omitted; send {} in that case.

userstringoptional
End-user identifier, defined by your app and unique within it. See [End User Identity](/en/api-reference/guides/end-user-identity).

3 status codes
204Conversation deleted successfully. No content returned.
400`not_chat_app` : App mode does not match the API route.

One documented failure

  • not_chat_app

    Please check if your app mode matches the right API route.

    not_chat_app

404`not_found` : Conversation does not exist.

One documented failure

  • not_found

    Conversation Not Exists.

    not_found

Error handling

A 400 is returned: not_chat_app : App mode does not match the API route. A 404 is returned: not_found : Conversation does not exist.