> ## 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. # Vider les numeros de la file > 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. ## Cibler la file d'un coequipier Par defaut, cet endpoint vide des numeros de la file assignee au proprietaire de la cle API. Pour vider la file d'un coequipier, passez `user_id` ou `email` en **query parameter**. 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 DELETE /v2/api/dialing-queues/current/numbers 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/numbers: delete: tags: - Power Dialer summary: Clear queue numbers description: >- 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. operationId: clearDialingQueueNumbers parameters: - name: number in: query required: false description: >- Phone number to remove (any format — normalized to E.164). Removes every entry matching this number unless `position` is also supplied. schema: type: string example: '+12125550010' - name: position in: query required: false description: >- 0-based position to remove. Combine with `number` to disambiguate when the same number appears more than once. schema: type: integer minimum: 0 example: 3 - name: unassigned in: query required: false description: >- When `true`, removes every queue entry that has not been called yet. Cannot be combined with `number` or `position`. schema: type: boolean example: true - name: user_id in: query required: false description: >- ID of a teammate whose queue to clear. Resolve teammate ids via [GET /v2/api/users](/en/v2/api-reference/users/list-users). Wins over `email` when both are provided. schema: type: string example: usr-15BB68317A7F06F0C07A3BBD8F244102A6872220 - name: email in: query required: false description: >- Email of a teammate whose queue to clear. Ignored when `user_id` is also supplied. schema: type: string format: email example: teammate@acme.com responses: '200': description: Numbers removed content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/ClearQueueNumbersResponse' example: data: removed: 4 '400': description: Filter missing or conflicting content: application/json: schema: $ref: 7e1afcc0-b8dd-4a14-8d64-64c2d4e10b12 examples: filter_required: summary: No filter supplied value: error: type: validation_error code: DIALING_QUEUE_DELETE_FILTER_REQUIRED message: >- Provide at least one of 'number', 'position', or 'unassigned=true' to clear queue numbers. retryable: false suggestion: >- Add 'number', 'position', or 'unassigned=true' as a query parameter. filter_conflict: summary: unassigned combined with number/position value: error: type: validation_error code: DIALING_QUEUE_DELETE_FILTER_CONFLICT message: >- 'unassigned=true' cannot be combined with 'number' or 'position'. retryable: false suggestion: >- Use 'unassigned=true' alone, or remove it and rely on 'number'/'position'. invalid_phone_number: summary: number is not a valid E.164 number value: error: type: validation_error code: INVALID_PHONE_NUMBER message: The phone number '+1212' is not a valid E.164 number. retryable: false param: number suggestion: Provide a valid E.164 phone number (e.g., +33612345678). '401': $ref: '#/components/responses/ApiUnauthorized' '404': description: Queue or position not found content: application/json: schema: $ref: 7e1afcc0-b8dd-4a14-8d64-64c2d4e10b12 examples: queue_not_found: summary: User has no Power Dialer queue value: error: type: not_found_error code: DIALING_QUEUE_NOT_FOUND message: No dialing queue found for the authenticated user. retryable: false suggestion: >- Create a queue by appending numbers with POST /v2/api/dialing-queues/current/numbers. position_not_found: summary: No entry at the requested position value: error: type: not_found_error code: QUEUE_NUMBER_POSITION_NOT_FOUND message: No queue number found at position 7. retryable: false param: position suggestion: >- Fetch the current queue with GET /v2/api/dialing-queues/current to see existing positions. assignee_not_found: summary: user_id or email does not match a teammate value: 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: ClearQueueNumbersResponse: type: object description: Result of clearing numbers from a Power Dialer queue. properties: removed: type: integer description: Number of queue entries that were removed. example: 4 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: 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 ````