> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Manage Power Dialer queues programmatically

The Power Dialer API lets you manage a user's queue — append numbers, configure it, clear or reset it, and read its state.

Each user has at most one active Power Dialer queue at a time. The queue is created implicitly the first time you append numbers or call reset.

## Required scope

All endpoints require the `DIALING_QUEUE_READ_WRITE` scope on your API key.

## Assigning a queue to a teammate

Every endpoint accepts `user_id` or `email` to act on a teammate's queue instead of the API key owner's. The wire location depends on the endpoint (query string vs JSON body) — see each endpoint's "Targeting a teammate's queue" section for specifics.

Rules that apply to every endpoint:

* `user_id` wins when both `user_id` and `email` are provided.
* The teammate must belong to the same team as the API key owner.
* If the resolved user doesn't exist or isn't a teammate, the API returns `404 ASSIGNEE_NOT_FOUND`. The same error covers both cases on purpose, so API consumers cannot enumerate users.
* When you append to a teammate who has no current queue, one is created with the API key owner as `creator_id` and the teammate as `assignee_id`.

## Endpoints

<CardGroup cols={2}>
  <Card title="Get current queue" href="/en/v2/api-reference/dialing-queues/get-current">
    Retrieve the queue assigned to a user (yourself or a teammate)
  </Card>

  <Card title="Upsert queue config" href="/en/v2/api-reference/dialing-queues/update-current">
    Update the queue name, voicemail handling, or do-not-disturb
  </Card>

  <Card title="Append numbers" href="/en/v2/api-reference/dialing-queues/append-numbers">
    Add phone numbers (and optional contact metadata) to a queue
  </Card>

  <Card title="Clear numbers" href="/en/v2/api-reference/dialing-queues/clear-numbers">
    Remove specific numbers, a position, or every unassigned entry
  </Card>

  <Card title="Reset queue" href="/en/v2/api-reference/dialing-queues/reset-current">
    Discard the current queue and start a fresh one
  </Card>
</CardGroup>
