These endpoints require a human member session. API keys can access account
resources, but they do not have a member profile and cannot perform member
administration.
Roles and permissions
viewer is read-only. It cannot create or change operations, credentials,
members or account settings. Keep at least one owner on every company
account.
Manage members in the portal
1
Open the company account settings
Sign in as an
owner, open the company account settings and select the
members section.2
Add or select a member
When adding a member, provide an email, a password with at least eight
characters and one of the three roles. When editing a member, select the
member before changing the role or status.
3
Confirm the member action
For adding a member, changing a role, blocking or unblocking a login, or
resetting a password, complete the
member_add OTP challenge when the portal
asks for it. The action applies immediately after successful confirmation.Manage members with the API
All examples use a human session token:1. Read your member profile
Use this endpoint to distinguish the signed-in member from the company account:404 member_not_found because they are not human members.
2. Add and list members
Adding a member is company-only. The default role isoperator when the
field is omitted:
3. Change a member role
Only an owner of a company account can change roles. The allowed values areowner, operator and viewer.
4. Block or unblock a member
Disabling a member revokes all of that member’s sessions immediately. Useactive to unblock the login.
5. Reset a member password
Resetting a member password also revokes all of that member’s sessions. To change your own password, usePOST /v1/me/password instead.
Errors and recovery
See the error reference for the complete API error catalogue.
Can an operator add or edit a member?
Can an operator add or edit a member?
No. Operators can operate the account’s products but cannot manage members or
credentials. An owner must perform the action.
Can I use an API key for member management?
Can I use an API key for member management?
No. Member administration is a human-session flow. API keys do not have a
member profile and
GET /v1/me/member returns member_not_found.What happens when I disable a member?
What happens when I disable a member?
All sessions belonging to that member are revoked immediately. The member
must be re-enabled by an owner before signing in again.
How do I change my own password?
How do I change my own password?
Use
POST /v1/me/password. The administrator reset endpoint is for another
member and returns self_action_forbidden when used on yourself.