Roles
What each role can do
In Settings, only owners and admins see the organization pages, such as Users, Billing and API keys. Other roles see their own account settings.
Assign roles
Owners and admins add members and change their roles in Settings > Users. Through the API, use Update Organization Members to add or remove a member, and Update Organization Member Permissions to change a role.- Default role. New members start with the organization’s default member role unless you pick one when you add them. It’s Viewer until an owner or admin changes it under Settings, or sets
preferences.default_member_rolewith Update Organization Properties. That call replaces the wholepreferencesobject, so include the preferences you want to keep. It can be any role except owner. - More than one role. The dashboard gives each member one role. Through the API, a member can hold several, and can do anything any of their roles allows.
- SSO members. If you use SSO, a member’s groups can replace the role you set. See Roles and SSO.
The owner
Each organization has one owner, usually the person who created it. The owner can’t be changed or removed in the dashboard or through the API, and can’t leave the organization. To transfer ownership, contact support. The previous owner becomes an admin.Roles and API keys
A full-access API key acts as the member who created it. Most endpoints that are limited by role check that member’s current role. Only owners and admins can create keys, so a full-access key usually has admin access.- If the member’s role changes, their full-access keys change with it.
- If the member is removed from the organization, their full-access keys are deleted.
- A few role limits apply only in the dashboard, so a full-access key isn’t held to them. For example, a full-access key can send calls whatever its creator’s role.
Roles and SSO
With SSO, Bland can set each member’s role from their groups in your identity provider. Groups can map to admin, operator, prompter or viewer, never owner. Bland checks a member’s groups each time they sign in with SSO:- If one of their groups maps to a role, Bland sets that role, replacing any role set in the dashboard or through the API.
- If none of their groups maps to a role, an existing member keeps their role, and a new member gets the default member role.
Docs for agents: llms.txt