Skip to main content

Bootstrap Org

POST 
/api/v1/public/bootstrap-org

Create the organisation for a self-signed-up user who has none.

Self-signup creates a Cognito identity but — until now — NO tenant: orgs were only born through admin flows (access-request approvals, sandbox provisioning) and team invites. A fresh user therefore 401'd on every org-scoped call, which dead-ended the SMP wizard at its first request.

Idempotent by contract: an authenticated user with an ACTIVE membership gets their existing org back (created=false); one without gets a new org with an org_owner membership. Requires a signed-in human (Cognito bearer/cookie) — an API key implies an org already exists, so the machine path has no business here.

Request​

Responses​

Successful Response