API Reference
Getting Started
Core Concepts
Backend API — Guides
Frontend API — Guides
OAuth & OpenID Connect — Guides
Enterprise: SSO & SCIM — Guides
Webhooks — Guides
SDKs
Backend API (BAPI)
Frontend API (FAPI)
Dashboard API
Public API
SCIM
OIDC
Platform

Client Organizations

AdminUpdated Sep 11, 2026

Client Organizations

Frontend API — publishable key (x-publishable-key) plus the user session.

10 routes. Each row is one endpoint with its explanation and whether it honours the Idempotency-Key header.

Method & path

Idem

Explanation

POST /v1/client/organizations

Create an organization, if the instance allows user-created ones.

GET /v1/client/organizations/:id

Read the active organization. Gated by the ACTIVE org role.

PATCH /v1/client/organizations/:id

Update the active organization. Requires org:sys_profile:manage.

GET /v1/client/organizations/:id/memberships

List members of the active organization as a display directory.

POST /v1/client/organizations/:id/invitations

Invite someone. Requires org:sys_memberships:manage.

DELETE /v1/client/organizations/:id/memberships/:userId

Remove a member. Removing the last admin returns LAST_ADMIN.

POST /v1/client/organization_invitations/:invitationId/accept

Accept an invitation addressed to one of your verified emails. Seats you as a member.

GET /v1/client/organizations/:id/membership_requests

List pending requests to join the active org. Requires org:sys_memberships:manage.

POST /v1/client/organizations/:id/membership_requests/:reqId/accept

Accept a join request, seating the user at the default member role (never admin).

POST /v1/client/organizations/:id/membership_requests/:reqId/reject

Reject a pending join request. No membership is created.

Was this page helpful?