Skip to main content
DELETE
Remove member
Required scope: PARTNER
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

1

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

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

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

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

The account id returned by Create account (usr-*).

member_id
string
required

The member's id (usr-*), from Add member or List members.

Response

Member removed