orgs

Create a new org — you become its owner; the tenant is provisioned asynchronously (any authenticated user; self-serve, no operator approval). Poll GET /v1/me for the new org.

post/v1/orgs

Request

  • Base URL: https://api.wavehouse.cloud
  • URL: https://api.wavehouse.cloud/v1/orgs
  • Auth: one of:
    • API key in cookie whc_session
    • HTTP bearer
    • API key in header X-API-Key

Headers

Idempotency-Keystring

A unique value you choose per logical request (a random UUID). A retry with the same key and the same request within 24 hours returns the first response, marked Idempotency-Replayed: true, instead of acting twice. The same key with a different request is refused with 422; one sent while the first is still running gets 409.

Request body

namestring required

the new org's display name

Response

Accepted

namestring required
statusstring required

always provisioning — the tenant is provisioned asynchronously by the organization.created webhook; poll GET /v1/me until the org appears and goes active

workos_org_idstring required

the new organization's id in the identity directory

Changes

No recorded changes to this operation across all 1 revision of this API.