Skip to main content
DELETE
/
api
/
chats
/
{id}
curl -X DELETE "https://your-domain.com/api/chats/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

true
Permanently deletes a chat and all associated messages. This action cannot be undone.
Users require the chat.delete permission to delete their own chats. Admin users can delete any chat.

​
Path Parameters

​
id
string
required
The unique identifier of the chat to delete

​
Response

​
Response
boolean
Returns true if the chat was successfully deleted, false otherwise
curl -X DELETE "https://your-domain.com/api/chats/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

true

​
Notes

  • Deleting a chat also removes all messages in the chat history
  • If the chat is shared, the shared version is also deleted
  • Orphaned tags (tags with no remaining chats) are automatically cleaned up
  • Admin users can delete any chat regardless of ownership
  • Non-admin users can only delete their own chats and require chat.delete permission