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
Revokes the member's eSIMs
Allo revokes 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.
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.
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.
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 with the kept number as phone_number. The new member takes it over with its history. See 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. |
PARTNER_ACCOUNT_MEMBER_NOT_FOUND | No member with this id is in the account's workspace (404). List them with 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. |