Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Membership & Invitations

:::info Coming Soon This feature is under active development. The design below reflects our planned implementation. :::

This page describes how users will be added to and managed within organizations.

How Membership Works

Users join organizations through invitations. An organization admin sends an invite, the user accepts, and they become a member with the assigned role.

Invitation Flow

Admin sends invitation

An organization admin creates an invitation for a specific email address and assigns a role (e.g., member, admin).

Email sent

The invited user receives an email with a link to accept the invitation.

User accepts

The user clicks the link and (if not already signed in) authenticates with the application.

User joins organization

The user is added to the organization with the role specified in the invitation.

Planned API Endpoints

Invite a member

POST /api/organizations/:id/invitations
{
  "email": "newmember@example.com",
  "role": "member"
}

List members

GET /api/organizations/:id/members

Update a member's role

PUT /api/organizations/:id/members/:user_id
{
  "role": "admin"
}

Remove a member

DELETE /api/organizations/:id/members/:user_id

Multiple Organizations

A user can belong to multiple organizations within the same application. For example, a freelance developer could be a member of several client organizations simultaneously.