Removes numbers from the queue assigned to the authenticated user. Exactly one filter must be supplied via query string: number (E.164), position (0-based…
DELETE/v2/api/dialing-queues/current/numbers
Targeting a teammate's queue
By default, this clears numbers from the queue assigned to the API key owner. To clear a teammate's queue, pass user_id or email as a query parameter. The teammate must belong to the same team as the API key owner.
user_id — wins when both are provided. Resolve teammate ids via GET /v2/api/users.
email — used only when user_id is absent.
If the resolved user isn't on your team, the response is 404 ASSIGNEE_NOT_FOUND.
Authorization
Authorizationstring · headerrequired
Api-Key ak_live_…
Query parameters
numberstring
Phone number to remove (any format — normalized to E.164). Removes every entry matching this number unless position is also supplied.
positioninteger
0-based position to remove. Combine with number to disambiguate when the same number appears more than once.
unassignedboolean
When true, removes every queue entry that has not been called yet. Cannot be combined with number or position.
user_idstring
ID of a teammate whose queue to clear. Resolve teammate ids via [GET /v2/api/users](/en/v2/api-reference/users/list-users). Wins over email when both are provided.
emailstring<email>
Email of a teammate whose queue to clear. Ignored when user_id is also supplied.
Responses
200Numbers removed
dataobject
Result of clearing numbers from a Power Dialer queue.