Skip to main content
DELETE
Delete label
Auth: TokenAccount or TokenInstanceRate-limit: Global (100/min) • Idempotent: yes

Description

Removes the label identified by tagId and automatically unassigns it from every chat that had it. Propagation to WhatsApp via app state may take 1 to 2 seconds.

Example

Success response

The envelope returns tag containing only the removed id and deleted: true, the other fields (name, color, type) come empty because the label no longer exists. Use success to audit the operation.
200 OK

Path parameters

string
required
Instance name.

Query params

string
required
ID of the label to remove.

Headers

Error responses

Error 400

List labels

Check available IDs.

Unassign label

Remove the label from a specific chat instead of deleting it.