Users and roles
Invite your team, give each person the access they need, and let colleagues on your company email domain request access themselves.
Roles
| Role | Access |
|---|---|
| Viewer | Read-only access to every page in the workspace, including findings, uptime and reports. |
| Analyst | Everything a viewer can do, plus add and verify domains, scan, triage findings, manage monitors and status page content. |
| Admin | Everything an analyst can do, plus members, billing, API tokens, webhooks, branding, source connections and the audit log. The API role name is tenant_admin. |
New members are analysts unless you choose another role. A workspace must always keep at least one active admin: you cannot demote, suspend or remove the last one, and you cannot suspend or remove yourself.
Inviting people
- Invite by email with a role. The invitation can be re-sent if it is not accepted.
- Domain invites: set the email domains your company uses, then create an invite link that anyone with an address on those domains can use to join. A link can have a limited number of uses and an expiry, and can be revoked.
- Access requests: someone who signs in with an address on an allowed domain can ask to join. Admins approve or reject the request, and are notified when it arrives.
- Plans can limit the number of users. When a limit applies, inviting past it is refused with a message.
MSP access to clients
On an MSP plan, admins of your workspace get admin access to each new client automatically. Other staff are added to a client from that client's own members list. See Client workspaces.
Audit trail
Membership changes, role changes and removals are recorded. See Audit log.
API
| Method | Path | Role | What it does |
|---|---|---|---|
GET | /api/orgs/:orgId/members | admin | List members and pending invites. |
POST | /api/orgs/:orgId/members | admin | Invite a member with an email and role. |
POST | /api/orgs/:orgId/members/:membershipId/resend-invite | admin | Send the invitation again. |
PATCH | /api/orgs/:orgId/members/:membershipId | admin | Change role or suspend. |
DELETE | /api/orgs/:orgId/members/:membershipId | admin | Remove a member. |
GET | /api/orgs/:orgId/email-domains | admin | Allowed company email domains. |
PUT | /api/orgs/:orgId/email-domains | admin | Replace the allowed domains. |
GET | /api/orgs/:orgId/domain-invites | admin | List domain invite links. |
POST | /api/orgs/:orgId/domain-invites | admin | Create a link. Needs at least one allowed email domain. |
POST | /api/orgs/:orgId/domain-invites/:id/revoke | admin | Revoke a link. |
GET | /api/orgs/:orgId/access-requests | admin | Pending requests. |
POST | /api/orgs/:orgId/access-requests/:id/approve | admin | Approve. |
POST | /api/orgs/:orgId/access-requests/:id/reject | admin | Reject. |