Revoke number access

Removes a user's or group's access grant on a phone number. A number must always keep at least one owner, so removing the last one is refused with 409. Removing a grant that does not exist still returns 200. The change is recorded in the number's history. An Admin key can manage access on any number on your account; any other key must itself be an owner of the number, and a key's grants are its own rather than those of the person who created it.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

ID of the phone number. Must be a UUID for a number on your account.

Body Params
string
enum
required

Whether the grant being removed belongs to a user or a group.

Allowed:
string
required

The user's ID, or one of the group names user, admin and owner.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json