Bermward

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

RoleAccess
ViewerRead-only access to every page in the workspace, including findings, uptime and reports.
AnalystEverything a viewer can do, plus add and verify domains, scan, triage findings, manage monitors and status page content.
AdminEverything 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

MethodPathRoleWhat it does
GET/api/orgs/:orgId/membersadminList members and pending invites.
POST/api/orgs/:orgId/membersadminInvite a member with an email and role.
POST/api/orgs/:orgId/members/:membershipId/resend-inviteadminSend the invitation again.
PATCH/api/orgs/:orgId/members/:membershipIdadminChange role or suspend.
DELETE/api/orgs/:orgId/members/:membershipIdadminRemove a member.
GET/api/orgs/:orgId/email-domainsadminAllowed company email domains.
PUT/api/orgs/:orgId/email-domainsadminReplace the allowed domains.
GET/api/orgs/:orgId/domain-invitesadminList domain invite links.
POST/api/orgs/:orgId/domain-invitesadminCreate a link. Needs at least one allowed email domain.
POST/api/orgs/:orgId/domain-invites/:id/revokeadminRevoke a link.
GET/api/orgs/:orgId/access-requestsadminPending requests.
POST/api/orgs/:orgId/access-requests/:id/approveadminApprove.
POST/api/orgs/:orgId/access-requests/:id/rejectadminReject.