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

# Supprimer une boîte de réception

> Deletes the inbox. Conversations are not affected. With `user_id`, an inbox with no source in a workspace the caller manages returns `404`, and an inbox that also holds lines from another workspace returns `403` `FORBIDDEN`.

> [!NOTE]
>
> **Scope requis :** `INBOXES_WRITE`

## Comportement

Supprime la boîte de réception et retourne un `204` sans corps. Les conversations qu'elle affichait ne sont pas touchées et restent sur leurs lignes.

Passez le paramètre de requête `user_id` pour supprimer la boîte d'un coéquipier. Seuls les admins et managers de l'espace de travail du coéquipier peuvent le faire. Une boîte sans source dans un espace de travail que l'appelant gère retourne une erreur `404`. Une boîte qui contient aussi des lignes d'un autre espace retourne une erreur `403` : seul le coéquipier peut la supprimer.

> [!WARNING]
>
> La suppression d'une boîte est définitive. Les assistants IA connectés via le [serveur MCP](https://help.withallo.com/fr/integrations/mcp.md) ne suppriment une boîte que si vous le demandez.

## Erreurs

| Statut | Code | Quand |
| - | - | - |
| `403` | `FORBIDDEN` | `user_id` est renseigné et l'appelant n'est ni admin ni manager de l'espace de travail de ce coéquipier, ou la boîte contient aussi des lignes d'un autre espace de travail |
| `404` | `INBOX_NOT_FOUND` | Aucune boîte avec cet ID n'appartient au propriétaire, ou, avec `user_id`, elle n'a aucune source dans un espace de travail que l'appelant gère |


## OpenAPI

````yaml DELETE /v2/api/inboxes/{inbox_id}
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.
  - name: Inboxes
    description: >-
      Personal inboxes: saved views of one or more lines, optionally narrowed to
      phone-menu options, with their own filters and notification setting.
paths:
  /v2/api/inboxes/{inbox_id}:
    delete:
      tags:
        - Inboxes
      summary: Delete inbox
      description: >-
        Deletes the inbox. Conversations are not affected. With `user_id`, an
        inbox with no source in a workspace the caller manages returns `404`,
        and an inbox that also holds lines from another workspace returns `403`
        `FORBIDDEN`.
      operationId: deleteInbox
      parameters:
        - name: inbox_id
          in: path
          required: true
          description: Inbox ID (`inb-*`).
          schema:
            type: string
            example: inb-abc123
        - name: user_id
          in: query
          description: >-
            Act on a teammate's inbox (`usr-*`). The caller must be an admin or
            manager of that teammate's workspace, and only reaches inboxes and
            sources in workspaces they manage. Omit to act on your own inboxes.
          schema:
            type: string
            example: usr-abc123
      responses:
        '204':
          description: Inbox deleted
        '401':
          $ref: '#/components/responses/ApiUnauthorized'
        '403':
          $ref: '#/components/responses/ApiForbidden'
        '404':
          $ref: '#/components/responses/ApiNotFound'
        '429':
          $ref: '#/components/responses/ApiRateLimited'
      security:
        - ApiKeyAuth: []
components:
  responses:
    ApiUnauthorized:
      description: Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiForbidden:
      description: API key lacks the required scope or access to the resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiNotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiRateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  schemas:
    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
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.