Organizations API

Multi-tenant organization management, invitations, and membership endpoints.

List User Organizations

GET/api/organizations

Get all organizations the authenticated user belongs to.

Response (200 OK)

json

Get Organization

GET/api/organizations/:orgId

Get details for a specific organization.

Response (200 OK)

json

Create Organization

POST/api/organizations

Create a new organization. User becomes admin.

Request Body

json

Response (201 Created)

json

Update Organization

PATCH/api/organizations/:orgId

Update organization details. Requires admin role.

Request Body

json

Response (200 OK)

json

List Organization Members

GET/api/organizations/:orgId/members

Response (200 OK)

json

Invite Member

POST/api/organizations/:orgId/invites

Send invitation email. Requires admin role.

Request Body

json

Response (201 Created)

json

Accept Invitation

POST/api/invites/:inviteId/accept

Response (200 OK)

json

Update Member Role

PATCH/api/organizations/:orgId/members/:memberId

Change member role. Requires admin role.

Request Body

json

Response (200 OK)

json

Remove Member

DELETE/api/organizations/:orgId/members/:memberId

Remove member from organization. Requires admin role.

Response (200 OK)

json

Delete Organization

DELETE/api/organizations/:orgId

Permanently delete organization. Requires owner role.

Request Body

json

Response (200 OK)

json

Related

OrganizationSwitcher →

UI for switching organizations

Multi-Tenant Example →

Complete multi-tenant architecture