v1

latestOpenAPI 3.0.32026-07-264955102.7 KB
Power Dialer

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 index), number + position together (delete a specific occurrence of a duplicate), or unassigned=true (remove every entry that has not been called yet). Combining unassigned with number or position is rejected. Pass user_id or email to clear a teammate's queue instead — user_id wins when both are provided.

delete/v2/api/dialing-queues/current/numbers

Query parameters

numberstring
Example:+12125550010

Phone number to remove (any format — normalized to E.164). Removes every entry matching this number unless position is also supplied.

positioninteger
Example:3

0-based position to remove. Combine with number to disambiguate when the same number appears more than once.

unassignedboolean
Example:true

When true, removes every queue entry that has not been called yet. Cannot be combined with number or position.

user_idstring
Example:usr-15BB68317A7F06F0C07A3BBD8F244102A6872220

ID of a teammate whose queue to clear. Resolve teammate ids via GET /v2/api/users. Wins over email when both are provided.

emailstring email
Example:teammate@acme.com

Email of a teammate whose queue to clear. Ignored when user_id is also supplied.

Response

Numbers removed

Example response

{
  "data": {
    "removed": 4
  }
}