Skip to main content

Create Invitation

POST 
/api/v1/workspaces/invitations

Send an invitation to join the workspace (PRD §4).

Role-based invitation rules:

  • Owners: Can invite to any role
  • Managers: Can invite to manager, field_worker, or member (NOT owner)
  • Field workers/members: Cannot invite

Creates a new invitation and sends an email to the invitee. Auto-revokes previous pending invitations for the same email/workspace.

Blocks:

  • Self-invites
  • Inviting existing workspace members
  • Inviting users already in another workspace (stricter than admin flow)

Rate limited to 10 invitations per hour per user (only counted after permission check passes).

Request​

Responses​

Created