Chat
Delete label
Removes a label and clears all of its assignments
DELETE
Delete label
Auth:
TokenAccount or TokenInstance • Rate-limit: Global (100/min) • Idempotent: yes
Description
Removes the label identified bytagId 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 returnstag 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
Related
List labels
Check available IDs.
Unassign label
Remove the label from a specific chat instead of deleting it.