WhatsApp Gateway
API referenceChats

Delete a chat

DELETE
/api/v1/sessions/{session}/chats/{cid}

Delete chat and locally stored messages for this session.

Local delete only; WhatsApp-side chat remains.

Errors: not_found if session or chat is missing, forbidden if missing send.

Authorization

AuthorizationBearer <token>

Send Authorization: Bearer <token>. The token can be a login JWT from the frontend or an api-key for a script. JWT access comes from the person's organization role. Api-key access comes from the permissions saved on the key.

In: header

Path Parameters

session*string

WhatsApp session id. Must belong to the caller organization.

Example"01HF..."
cid*string

Chat JID to delete from local storage.

Example"6281234567890@s.whatsapp.net"

Response Body

application/json

curl -X DELETE "https://example.com/api/v1/sessions/01HF.../chats/6281234567890@s.whatsapp.net"
Empty
{  "error": {    "code": "not_found",    "details": {      "property1": null,      "property2": null    },    "message": "session not found"  }}