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

# Mettre a jour la file courante

> Creates or updates the config of the queue assigned to the authenticated user. Send `user_id` or `email` to act on a teammate's queue instead — `user_id` wins when both are provided.

## Cibler la file d'un coequipier

Par defaut, cet endpoint met a jour la config de la file assignee au proprietaire de la cle API. Pour mettre a jour la file d'un coequipier, envoyez `user_id` ou `email` dans le **corps JSON**. Le coequipier doit appartenir a la meme equipe que le proprietaire de la cle API.

* `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`.


## OpenAPI

````yaml PATCH /v2/api/dialing-queues/current
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 configurations to receive real-time notifications about
      events in your Allo account. Each webhook is associated with a specific
      Allo phone number.
  - 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.
paths:
  /v2/api/dialing-queues/current:
    patch:
      tags:
        - Power Dialer
      summary: Upsert current queue
      description: >-
        Creates or updates the config of the queue assigned to the authenticated
        user. Send `user_id` or `email` to act on a teammate's queue instead —
        `user_id` wins when both are provided.
      operationId: upsertCurrentDialingQueue
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpsertDialingQueueRequest'
            examples:
              self:
                summary: Update your own queue
                value:
                  name: Cold Calls
              teammate_by_pid:
                summary: Update a teammate's queue by user_id
                value:
                  name: Cold Calls
                  user_id: usr-15BB68317A7F06F0C07A3BBD8F244102A6872220
      responses:
        '200':
          description: Updated queue
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/DialingQueue'
        '400':
          $ref: '#/components/responses/ApiValidationError'
        '401':
          $ref: '#/components/responses/ApiUnauthorized'
        '404':
          description: Assignee not found
          content:
            application/json:
              schema:
                $ref: 7e1afcc0-b8dd-4a14-8d64-64c2d4e10b12
              example:
                error:
                  type: not_found_error
                  code: ASSIGNEE_NOT_FOUND
                  message: No team member found for the provided 'user_id' or 'email'.
                  retryable: false
                  suggestion: >-
                    List your teammates with GET /v2/api/users and use one of
                    their ids as 'user_id', or pass a team-member email.
        '429':
          $ref: '#/components/responses/ApiRateLimited'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    UpsertDialingQueueRequest:
      type: object
      description: >-
        Creates or updates the queue config. All fields are optional — only the
        fields you supply are touched. Pass `user_id` or `email` to act on a
        teammate's queue instead.
      properties:
        name:
          type: string
          nullable: true
          description: New queue name (1–255 characters)
          minLength: 1
          maxLength: 255
        voicemail_handling:
          type: string
          nullable: true
          enum:
            - SKIP
            - NO_SKIP
          description: How the Power Dialer reacts when the call hits voicemail.
        do_not_disturb:
          type: string
          nullable: true
          enum:
            - ENABLED
            - DISABLED
          description: Silence inbound calls while running the queue.
        user_id:
          type: string
          nullable: true
          description: >-
            Optional. ID of a teammate whose queue config should be updated. The
            teammate must belong to the same team as the API key owner. Wins
            over `email` when both are provided.
          example: usr-15BB68317A7F06F0C07A3BBD8F244102A6872220
        email:
          type: string
          format: email
          nullable: true
          description: >-
            Optional. Email of a teammate whose queue config should be updated.
            Ignored when `user_id` is also supplied.
          example: teammate@acme.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
    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.
    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
  responses:
    ApiValidationError:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    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

````