Loading…
Deletes a specific chat.
| Permission | Description |
|---|---|
chats.delete | Delete your own chats |
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| chat-id | int | Yes | ID of the chat to delete | 123 |
DELETE /api/v1/chats/123
Authorization: Bearer {token}
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: “چت با موفقیت حذف شد.”).
| Status | Description | Reference |
|---|---|---|
| 401 | Unauthorized | Authentication error |
| 403 | Forbidden (no permission) | Permission error |
| 404 | Not found | Not-found error |