# Remove member

> 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…

`DELETE /v2/api/partner/accounts/{id}/members/{member_id}`

<Note>
**Required scope:** `PARTNER`
</Note>

Removes a member from one of your accounts, for example when a collaborator leaves your customer's company. The member's numbers stay on the account with their history, so you can give them to the collaborator who replaces them. The response is `204` with no body.

## What Allo does

<Steps>
  <Step title="Revokes the member's eSIMs">
    Allo [revokes](/docs/white-label/revoke-esim) every eSIM the member holds, and every eSIM on their numbers (including one ordered without `holder_id`), before anything else, so their phone stops ringing right away, even if a later step fails. Each eSIM's data tier ends now.
  </Step>
  <Step title="Removes the member from the workspace">
    The member loses access to the account's workspace. Their numbers move to the account itself, with their call and message history, and ring the Allo apps.
  </Step>
  <Step title="Swaps the seat for extra numbers">
    The member's seat stays paid until the end of the current billing period. From the next invoice, the account's subscription bills the kept numbers as extra numbers instead of the seat, with no proration. Allo only adds the extra numbers the account does not already pay for.
  </Step>
</Steps>

If the account is being deactivated at the end of its billing period, Allo bills nothing more for the kept numbers.

## How to give the number to a new collaborator

Call [Add member](/docs/white-label/add-member) with the kept number as `phone_number`. The new member takes it over with its history. See [How to replace a collaborator who leaves](/docs/white-label/overview#how-to-replace-a-collaborator-who-leaves) for the full flow, including a new eSIM.

## Errors

| Code | What it means |
|------|---------------|
| `PARTNER_ACCOUNT_OWNER_NOT_REMOVABLE` | `member_id` is the account itself, which is not a member (`400`). To end the account, use [Deactivate account](/docs/partner/delete-account). |
| `PARTNER_ACCOUNT_MEMBER_NOT_FOUND` | No member with this id is in the account's workspace (`404`). List them with [List members](/docs/white-label/list-members). |
| `PARTNER_ACCOUNT_NOT_FOUND` | Your API key did not create this account, or the account is deactivated (`404`). |
| `PARTNER_ESIM_MOVE_IN_PROGRESS` | One of the member's eSIMs is being moved between the network and the eSIM right now (`409`). Always `retryable: true`: retry in a few minutes. Nothing was changed. |
| `PARTNER_ESIM_MOVE_FAILED` | One of the member's eSIMs failed to move between the network and the eSIM (`409`). Contact Allo support. Nothing was changed. |
| `PARTNER_ACCOUNT_BUSY` | Another member or number is being changed on this account right now (`409`). Always `retryable: true`: retry in a few seconds. |
