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

# Retirer un membre

> Removes a member from one of your accounts. Allo revokes the member's eSIMs first, so their phone stops ringing right away, then removes the member from the account's workspace. The member's numbers stay on the account, with their history. The seat stays paid until the end of the current billing period, and from the next invoice the account's subscription bills the kept numbers as extra numbers, with no proration. Requires the `PARTNER` scope.

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

Retire un membre de l'un de vos comptes, par exemple quand un collaborateur quitte l'entreprise de votre client. Les numéros du membre restent sur le compte avec leur historique, pour que vous puissiez les donner au collaborateur qui le remplace. La réponse est `204`, sans corps.

## Ce que fait Allo

**1. Révoque les eSIM du membre**

Allo [révoque](https://help.withallo.com/fr/v2/api-reference/white-label/revoke-esim.md) toutes les eSIM du membre, et toutes les eSIM de ses numéros (y compris une eSIM commandée sans `holder_id`), avant toute autre étape, pour que son téléphone cesse de sonner immédiatement, même si une étape suivante échoue. Le palier de données de chaque eSIM s'arrête tout de suite.

**2. Retire le membre du workspace**

Le membre perd l'accès au workspace du compte. Ses numéros passent au compte lui-même, avec leur historique d'appels et de messages, et sonnent sur les apps Allo.

**3. Remplace le siège par des numéros supplémentaires**

Le siège du membre reste payé jusqu'à la fin de la période de facturation en cours. À partir de la facture suivante, l'abonnement du compte facture les numéros conservés comme numéros supplémentaires à la place du siège, sans prorata. Allo n'ajoute que les numéros supplémentaires que le compte ne paie pas déjà.

Si le compte est en cours de désactivation à la fin de sa période de facturation, Allo ne facture rien de plus pour les numéros conservés.

## Comment donner le numéro à un nouveau collaborateur

Appelez [Ajouter un membre](https://help.withallo.com/fr/v2/api-reference/white-label/add-member.md) avec le numéro conservé comme `phone_number`. Le nouveau membre le reprend avec son historique. Voir [Comment remplacer un collaborateur qui part](https://help.withallo.com/fr/v2/api-reference/white-label/overview.md#comment-remplacer-un-collaborateur-qui-part) pour le parcours complet, nouvelle eSIM comprise.

## Erreurs

| Code | Signification |
| - | - |
| `PARTNER_ACCOUNT_OWNER_NOT_REMOVABLE` | `member_id` est le compte lui-même, qui n'est pas un membre (`400`). Pour mettre fin au compte, utilisez [Désactiver un compte](https://help.withallo.com/fr/v2/api-reference/partner/delete-account.md). |
| `PARTNER_ACCOUNT_MEMBER_NOT_FOUND` | Aucun membre avec cet id dans le workspace du compte (`404`). Listez-les avec [Lister les membres](https://help.withallo.com/fr/v2/api-reference/white-label/list-members.md). |
| `PARTNER_ACCOUNT_NOT_FOUND` | Votre API key n'a pas créé ce compte, ou le compte est désactivé (`404`). |
| `PARTNER_ESIM_MOVE_IN_PROGRESS` | L'une des eSIM du membre est en cours de bascule entre le réseau et l'eSIM (`409`). Toujours `retryable: true` : réessayez dans quelques minutes. Rien n'a été modifié. |
| `PARTNER_ESIM_MOVE_FAILED` | La bascule de l'une des eSIM du membre entre le réseau et l'eSIM a échoué (`409`). Contactez le support Allo. Rien n'a été modifié. |
| `PARTNER_ACCOUNT_BUSY` | Un autre membre ou numéro est en cours de modification sur ce compte (`409`). Toujours `retryable: true` : réessayez dans quelques secondes. |


## OpenAPI

````yaml DELETE /v2/api/partner/accounts/{id}/members/{member_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: Fax
    description: >-
      Send a PDF as a fax from an Allo line with fax turned on. Sent and
      received faxes appear in conversation items.
  - 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/partner/accounts/{id}/members/{member_id}:
    delete:
      tags:
        - White label
      summary: Remove member
      description: >-
        Removes a member from one of your accounts. Allo revokes the member's
        eSIMs first, so their phone stops ringing right away, then removes the
        member from the account's workspace. The member's numbers stay on the
        account, with their history. The seat stays paid until the end of the
        current billing period, and from the next invoice the account's
        subscription bills the kept numbers as extra numbers, with no proration.
        Requires the `PARTNER` scope.
      operationId: removePartnerAccountMember
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The account id returned by Create account (`usr-*`).
        - name: member_id
          in: path
          required: true
          schema:
            type: string
          description: The member's `id` (`usr-*`), from Add member or List members.
      responses:
        '204':
          description: Member removed
        '400':
          description: >-
            The `member_id` is the account itself, which is not a member
            (PARTNER_ACCOUNT_OWNER_NOT_REMOVABLE). To end the account, use
            `DELETE /v2/api/partner/accounts/{id}`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
        '401':
          $ref: '#/components/responses/ApiUnauthorized'
        '403':
          description: The API key lacks the PARTNER scope.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
        '404':
          description: >-
            No account with this id was provisioned by your API key, or the
            account is deactivated (PARTNER_ACCOUNT_NOT_FOUND), or no member
            with this id is in the account's workspace
            (PARTNER_ACCOUNT_MEMBER_NOT_FOUND).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
        '409':
          description: >-
            One of the member's eSIMs is being moved between the network and the
            eSIM right now (PARTNER_ESIM_MOVE_IN_PROGRESS), or another member or
            number is being changed on this account (PARTNER_ACCOUNT_BUSY). Both
            are `retryable: true`: retry in a few minutes for the first, a few
            seconds for the second.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
        '429':
          $ref: '#/components/responses/ApiRateLimited'
      security:
        - ApiKeyAuth: []
components:
  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'
  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.