---
title: "Clear queue numbers"
method: DELETE
path: "/v2/api/dialing-queues/current/numbers"
tags: ["Power Dialer"]
---

# Clear queue numbers

`DELETE /v2/api/dialing-queues/current/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.

## Query parameters

- `number` string
- `position` integer
- `unassigned` boolean
- `user_id` string
- `email` string, email

## Response `200`

Numbers removed

- object
  - `data` ClearQueueNumbersResponse — Result of clearing numbers from a Power Dialer queue.
    - `removed` integer — Number of queue entries that were removed.

## Other responses

- `400` — Filter missing or conflicting
- `401` — Invalid or missing API key
- `404` — Queue or position not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/withallo/apis/allo-api.md) · [All operations](https://skmtc.net/withallo/apis/allo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/withallo/allo-api/versions/9aab4db82933/schema)