Sign in
Platform

Create Tenant

Required role: owner.

Explicitly create a tenant, rather than relying on first login. A login resolves its tenant by name, so a user whose identity provider asserts this name lands in the tenant created here.

post/v0/tenants

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Request body

namestring required

Example request

{
  "name": "acme"
}

Response

Tenant with that name already exists

idstring uuid required
initial_providerstring required

The OIDC issuer this tenant was first provisioned under. Provenance only: a tenant is resolved by name, so this does not affect which tenant a login reaches.

namestring required

Changes

No recorded changes to this operation across all 51 revisions of this API.