Update number access

Changes an existing grant's role between owner and member. The principal must already have a grant on the number — use POST to add one. A number must always keep at least one owner, so demoting the last one is refused with 409. The updated grant rows are returned as stored, including the account ID, the phone number, the principal, the role and the nullable granted_by and granted_at. Role changes are recorded in the number's history.

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 existing grant belongs to a user or a group.

Allowed:
string
required

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

string
enum
required

The role to move the principal to: owner or member.

Allowed:
Responses

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