Allo

Clear queue numbers

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.

1 fields
removedinteger

Number of queue entries that were removed.

400Filter missing or conflicting
errorobject
6 fields
typestring
codestring
messagestring
retryableboolean
request_idstring
retry_after_secondsinteger | null
401
404Queue or position not found
errorobject
6 fields
typestring
codestring
messagestring
retryableboolean
request_idstring
retry_after_secondsinteger | null
429