API DocsAPI Docs / Chats / Delete

DELETE /api/v1/chats/{chat-id}

Deletes a specific chat.

Permissions

URL Parameters

Request Example

DELETE /api/v1/chats/123
Authorization: Bearer {token}

Response

204 No Content

Despite the 204, this endpoint does return a JSON body — a localized confirmation message. HTTP defines 204 as bodyless, so some clients and proxies discard it; treat the body as informational, not something to depend on.

{
  "message": "Chat deleted successfully."
}

Localized from messages.chats.deleted_successfully (fa: “چت با موفقیت حذف شد.”).

Error Responses