# 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.

A queue holds up to 25,000 numbers. An append that would go past that limit fails with `400 DIALING_QUEUE_LIMIT_REACHED`.

## 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="/docs/dialing-queues/get-current">
    Retrieve the queue assigned to a user (yourself or a teammate)
  </Card>
  <Card title="Upsert queue config" href="/docs/dialing-queues/update-current">
    Update the queue name, voicemail handling, or do-not-disturb
  </Card>
  <Card title="Append numbers" href="/docs/dialing-queues/append-numbers">
    Add phone numbers (and optional contact metadata) to a queue
  </Card>
  <Card title="Clear numbers" href="/docs/dialing-queues/clear-numbers">
    Remove specific numbers, a position, or every unassigned entry
  </Card>
  <Card title="Reset queue" href="/docs/dialing-queues/reset-current">
    Discard the current queue and start a fresh one
  </Card>
  <Card title="Reassign queue" href="/docs/dialing-queues/assign-queue">
    Move a queue and its numbers to another team member
  </Card>
</CardGroup>
