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.
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, passuser_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 viaGET /v2/api/users.email— used only whenuser_idis absent.
404 ASSIGNEE_NOT_FOUND.Authorizations
Query Parameters
Phone number to remove (any format — normalized to E.164). Removes every entry matching this number unless position is also supplied.
"+12125550010"
0-based position to remove. Combine with number to disambiguate when the same number appears more than once.
x >= 03
When true, removes every queue entry that has not been called yet. Cannot be combined with number or position.
true
ID of a teammate whose queue to clear. Resolve teammate ids via GET /v2/api/users. Wins over email when both are provided.
"usr-15BB68317A7F06F0C07A3BBD8F244102A6872220"
Email of a teammate whose queue to clear. Ignored when user_id is also supplied.
Response
Numbers removed
Result of clearing numbers from a Power Dialer queue.