WhatsApp API Platform
Agent Assignments

Clear all agent assignments for a customer

DELETE
/api/v1/agents/customers/{customer}/assignments

Removes every agent assigned to the customer in one call.

Authorization

ApiKeyAuth
X-API-Key<token>

API key from your dashboard (Settings > API Keys)

In: header

Path Parameters

customer*string

Customer id (cuid2) or public identifier

Query Parameters

wabaId?string

WABA id — required only when the identifier matches multiple customers across WABAs.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://loading/api/v1/agents/customers/919876543210/assignments"
{
  "success": true,
  "data": {
    "removed_count": 0
  }
}
{
  "success": false,
  "message": "to field is required"
}
{
  "success": false,
  "message": "user not authenticated"
}
{
  "success": false,
  "message": "forbidden"
}
{
  "success": false,
  "message": "customer not found"
}
{
  "success": false,
  "message": "internal server error"
}