Team collaboration
Workspaces, roles, invites, and what each role can do.
Workspaces are how you collaborate. Each workspace has a member list with roles, its own credentials, header profiles, and integrations.
Inviting a member
From workspace settings → Members → Invite:
- Enter the invitee’s email.
- Pick a role: Owner, Editor, or Viewer.
- Send.
The invitee gets an email with a unique link. They sign in (or sign up if new) and join the workspace automatically.
Roles
| Capability | Owner | Editor | Viewer |
|---|---|---|---|
| View specs | ✓ | ✓ | ✓ |
| Run requests | ✓ | ✓ | ✓ |
| Edit specs | ✓ | ✓ | |
| Create / delete specs | ✓ | ✓ | |
| Manage credentials | ✓ | ✓ | |
| Manage members | ✓ | ||
| Manage integrations | ✓ | ||
| Transfer / delete workspace | ✓ |
Pick Viewer for stakeholders, partners, and read-only access. Pick Editor for engineers actively maintaining the spec. Reserve Owner for people you trust to manage the team.
Pending invites
The members list shows pending invites separately. Cancel an invite that hasn’t been redeemed; the link stops working immediately.
Changing roles
Owners can change any member’s role from the members list. Demoting an Owner to Editor or Viewer requires another Owner present (the workspace must always have at least one Owner).
Transferring ownership
From workspace settings → Transfer ownership:
- Pick another current Owner (or any current member you’d like to elevate).
- Confirm.
You become an Editor automatically; the new Owner has full rights.
Leaving / removing
Members can leave a workspace at any time (Owners can leave only after transferring ownership). Owners can remove any member; the removed user loses access immediately.
Multiple workspaces per user
Your account can be in any number of workspaces. The dashboard shows them all; each has its own specs, settings, integrations, and history.
Audit signals
Operations carry an x-updated-at extension stamp showing when they were last modified — visible in the editor and in the doc view, useful for tracking who changed what when paired with Slack notifications on spec changes.