Documentation
Teams & roles
Crowswatch is built for teams. Monitors, integrations, and alerts all belong to a team, and roles control who can change them. This guide covers inviting people, roles and permissions, and team settings.
Organizations, teams & the active team
Your account is an organization that holds one or more teams. Everything you configure belongs to the currently active team. If you're in more than one team, use the switcher at the top of the dashboard sidebar to move between them. Your first team is created for you when you sign up, with you as its owner.
Invite a teammate
- Open Teams in the sidebar (owners and admins).
- Open the invite dialog, enter the person's email and pick a role (member, admin, or owner).
- Crowswatch creates an invite and gives you a link of the form
/invite/<token>. Share it with them. - They open the link, sign in or create an account, and click Accept & join team.
Roles & permissions
There are three built-in roles. This is roughly what each can do by default:
| Permission | Owner | Admin | Member |
|---|---|---|---|
| View dashboard, incidents & stack | Yes | Yes | Yes |
| Acknowledge incidents | Yes | Yes | No |
| Export PDF reports | Yes | Yes | No |
| Add & remove services | Yes | Yes | No |
| Manage integrations & API keys | Yes | Yes | No |
| Invite & remove members | Yes | Yes | No |
| Change member roles | Yes | No | No |
| Manage team settings | Yes | No | No |
In short: members are read-only, admins run day-to-day operations, and owners additionally control roles and settings.
Custom roles
Beyond the three built-ins, owners and admins can create custom roles with a specific mix of permissions (view dashboard, acknowledge, export, add services, manage integrations, invite, remove, change roles, manage settings) and assign them per member. If a custom role is deleted, its members fall back to their built-in role.
Managing members
Change a role
Only owners can change a member's built-in role. Owners or admins can assign a custom role.
Remove a member
Owners and admins can remove members, and cancel pending invitations that haven't been accepted.
Team settings
| Setting | Who can change it |
|---|---|
| Rename team | Owner |
| Rename organization | Organization owner |
| Delete team | Organization owner (can’t delete the last team) |
| Allowed email domains for invites | Owner (admins if permitted) |
| Dashboard auto-refresh (30–600s) | Owner (admins if permitted) |
| Member permission toggles | Owner (admins if permitted) |
Troubleshooting
An invite link says expired or already used
Invites are single-use and expire after 7 days. Send a fresh invite from the Teams page.
Someone can’t accept an invite
The invite is tied to the email it was sent to — they must accept it while signed in with that address. Domain restrictions, if set, also apply.
An admin can’t change roles
Changing roles is owner-only by default. An owner can grant admins that ability in team settings.