Workspaces & members

Multi‑tenant workspaces, roles, and invitation flows for SaaS‑style usage.

Concepts

  • Each workspace represents a company, business unit, or environment.
  • Users can belong to multiple workspaces with different roles.
  • All API calls are scoped by workspace ID.

Inviting members

  1. Open Settings → Workspace in the dashboard.
  2. Enter the invitee’s email and choose a role (admin, member, viewer).
  3. Click Invite. An invitation is created and an invite link is shown.
  4. Copy the invite link and send it to the invitee (e.g. via email or Slack).
  5. The invitee opens the link (/invite?token=...). If they are not logged in, they are redirected to log in, then back to the invite page.
  6. Once they accept, they are added to the workspace and their account is switched to that workspace.

Invitations expire after 7 days. Free plan is limited to 1 member; Team and Business plans support more members (see Billing).

Accept invitation API

POST /api/workspace/invitations/accept — Body: { token, userId, userEmail }. Validates the token and email, adds the user to the workspace, and sets the invitation as accepted. The client should call this when the user opens the invite link while logged in.