> ## 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. # Reassigner une file > Reassigns a dialing queue to another member of the team. The queue keeps its numbers and its creator. Only API keys of a team admin or manager can call this endpoint, and the API key owner must be the queue's creator or current assignee. **Scope requis :** `DIALING_QUEUE_READ_WRITE` Deplace une file vers un autre membre de votre equipe. La file conserve ses numeros et son `creator_id` ; seul `assignee_id` change. Le nouvel assigne voit la file dans son Power Dialer immediatement. ## Qui peut reassigner * La cle API doit appartenir a un **admin** ou un **manager** de l'equipe. Une cle de membre recoit `403 DIALING_QUEUE_ASSIGN_FORBIDDEN`. * Le proprietaire de la cle API doit etre le createur ou l'assigne actuel de la file. Sinon la reponse est `404 DIALING_QUEUE_NOT_FOUND`. ## Choisir le nouvel assigne Envoyez `user_id` ou `email` dans le **corps JSON**. L'un des deux est obligatoire (`400 DIALING_QUEUE_ASSIGNEE_REQUIRED`). * `user_id` — l'emporte quand les deux sont fournis. Resolvez les ids des coequipiers via [`GET /v2/api/users`](/fr/v2/api-reference/users/list-users). * `email` — utilise uniquement quand `user_id` est absent. Si l'utilisateur resolu n'est pas dans votre equipe, la reponse est `404 ASSIGNEE_NOT_FOUND`. ## Sessions d'appel ouvertes Une file avec une session d'appel ouverte ne peut pas etre reassignee (`409 DIALING_QUEUE_SESSION_ACTIVE`). Terminez la session dans l'app Allo, puis reessayez. ## OpenAPI ````yaml PATCH /v2/api/dialing-queues/{queue_id}/assignee openapi: 3.0.3 info: title: Allo API description: >- Allo API provides programmatic access to your Allo account, allowing you to manage webhooks, retrieve calls and contacts, and send SMS messages. All requests to `/v1/api/**` endpoints automatically go through quota checking and scope validation. version: 1.0.0 contact: name: Allo Support servers: - url: https://api.withallo.com description: Production server security: [] tags: - name: Summary Templates description: >- Manage call summary templates that control how AI-generated call summaries are structured for your team. - name: Webhooks description: >- Manage webhook endpoints to receive real-time notifications about events in your Allo account. Each endpoint subscribes to one or more event topics and is verified with a signing secret. - name: Calls description: >- Retrieve and search call records with filtering and pagination. Filter calls by your Allo phone number. - name: Contacts description: >- Search and retrieve contact information with sorting and pagination. Includes engagement level tracking. - name: SMS description: Send SMS messages to phone numbers using your Allo numbers. - name: Phone Numbers description: Retrieve information about your Allo phone numbers. - name: Analytics description: Pre-computed call metrics, team performance, and outbound dial funnel - name: CRM description: Manage people, companies, and deals in your CRM. - name: Notes description: >- Internal team notes on conversations and CRM people, with @mention support. Notes are never visible to the contact. - name: Threads description: >- Team discussion threads attached to a conversation item (call, SMS, or conversation note). One thread per item. - name: AI Receptionist description: >- Read and write the AI receptionist configuration of a phone line: business details, voice, prompt, capabilities, business hours, transfer rules, scheduling calendars and knowledge sources. paths: /v2/api/dialing-queues/{queue_id}/assignee: patch: tags: - Power Dialer summary: Reassign queue description: >- Reassigns a dialing queue to another member of the team. The queue keeps its numbers and its creator. Only API keys of a team admin or manager can call this endpoint, and the API key owner must be the queue's creator or current assignee. operationId: assignDialingQueue parameters: - name: queue_id in: path required: true description: Id of the dialing queue. schema: type: string example: pdl-174AB37D545367EB5CE26784EE7A376202B2BFAE requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssignDialingQueueRequest' examples: by_user_id: summary: Reassign by user_id value: user_id: usr-15BB68317A7F06F0C07A3BBD8F244102A6872220 by_email: summary: Reassign by email value: email: rep@example.com responses: '200': description: Reassigned queue content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/DialingQueue' '400': description: Neither `user_id` nor `email` provided content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: type: validation_error code: DIALING_QUEUE_ASSIGNEE_REQUIRED message: >- Provide 'user_id' or 'email' of the team member the dialing queue should be assigned to. retryable: false suggestion: >- List your teammates with GET /v2/api/users and pass one of their ids as 'user_id'. '401': $ref: '#/components/responses/ApiUnauthorized' '403': description: >- The API key belongs to a team member without the admin or manager role, or lacks the required scope content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: type: permission_error code: DIALING_QUEUE_ASSIGN_FORBIDDEN message: Only a team admin or manager can reassign a dialing queue. retryable: false suggestion: Use an API key that belongs to a team admin or manager. '404': description: Queue or assignee not found content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: type: not_found_error code: DIALING_QUEUE_NOT_FOUND message: No dialing queue found for the requested id. retryable: false suggestion: >- List queues with GET /v2/api/dialing-queues or create one with POST /v2/api/dialing-queues. '409': description: The queue has an open dialing session content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: type: conflict_error code: DIALING_QUEUE_SESSION_ACTIVE message: >- The dialing queue has an open dialing session, so its assignee cannot change. retryable: false suggestion: End the session in the Allo app, then retry the request. '429': $ref: '#/components/responses/ApiRateLimited' security: - ApiKeyAuth: [] components: schemas: AssignDialingQueueRequest: type: object description: >- The team member the queue should be assigned to. Provide `user_id` or `email`; `user_id` wins when both are provided. properties: user_id: type: string description: >- Id of the new assignee. Resolve teammate ids via `GET /v2/api/users`. example: usr-15BB68317A7F06F0C07A3BBD8F244102A6872220 email: type: string format: email description: Email of the new assignee. Used only when `user_id` is absent. example: rep@example.com DialingQueue: type: object description: A user's Power Dialer queue with its configuration and numbers. properties: id: type: string description: Unique queue identifier (KSUID with `pdl` prefix) name: type: string nullable: true description: Display name of the queue creator_id: type: string description: >- User ID of the queue creator — the user (or API key owner) that created the queue. assignee_id: type: string nullable: true description: >- User ID of the user expected to run the queue. `GET /current` returns the queue where this matches the authenticated user (or the user resolved from `user_id` / `email`). Defaults to the creator when none was specified at creation time. voicemail_handling: type: string enum: - SKIP - NO_SKIP description: >- How the Power Dialer reacts when the call lands in voicemail. `SKIP` advances to the next number; `NO_SKIP` keeps the user on the call. do_not_disturb: type: string enum: - ENABLED - DISABLED description: >- When `ENABLED`, incoming calls are silenced while the queue is being run. numbers: type: array items: $ref: '#/components/schemas/QueueNumber' created_at: type: string format: date-time updated_at: type: string format: date-time ApiError: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string retryable: type: boolean request_id: type: string retry_after_seconds: type: integer nullable: true QueueNumber: type: object description: A phone number entry in a Power Dialer queue properties: number_to: type: string description: E.164 destination phone number position: type: integer description: Order within the queue (0-based) created_at: type: string format: date-time updated_at: type: string format: date-time call_start_date: type: string format: date-time nullable: true description: >- When the user started calling this entry. `null` if the entry is still unassigned. call_id: type: string nullable: true description: >- ID of the call placed for this entry (`cll-*`). `null` until a call is placed. routing_result: type: string nullable: true enum: - FAILED - RECEIVED - BLOCKED - ANSWERED - TRANSFERRED_BLAND - TRANSFERRED_ELEVEN_LABS - TRANSFERRED_EXTERNAL - FAILED_EXTERNAL - VOICEMAIL - CLOSED description: Final routing outcome of the call placed for this entry. sync_status: type: string enum: - NOT_SYNCED - PROCESSING - SYNCED description: State of contact creation/sync for this entry. detected_outbound_voicemail: type: boolean nullable: true description: Whether the call was detected as having reached a voicemail box. not_reached_destination_reason: type: string nullable: true enum: - BUSY - CALLEE_TEMPORARILY_UNAVAILABLE - RING_TIMEOUT - NOT_IN_SERVICE - DECLINED - NETWORK_ERROR description: Why the call did not reach the contact (only set when applicable). voicemail_left: type: boolean nullable: true description: Whether the user left a voicemail on this entry. call_status: type: string nullable: true enum: - QUEUED - SKIPPED - VOICEMAIL - CONNECTED - TRANSFERRED - NO_ANSWER - BUSY - WRONG_NUMBER description: >- Status of this entry, derived from the call placed for it. `QUEUED`: no call yet, or the call is still in progress. `SKIPPED`: skipped in the Power Dialer with no call placed (if a call is placed for it later, the status follows that call). `VOICEMAIL`: the call reached a voicemail box. `CONNECTED`: the call was answered at route level (`routing_result` is `ANSWERED`), no voicemail was detected and no `not_reached_destination_reason` is set; this can over-report a real conversation. `TRANSFERRED`: the call was transferred. `BUSY`: the destination was busy. `WRONG_NUMBER`: the destination is not in service. `NO_ANSWER`: the call ended without an answer, including the other `not_reached_destination_reason` values and any other final route status (failed, blocked, closed, handled by call flow). responses: ApiUnauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiRateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.