Skip to main content

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.

Request Body — REQUIRED
name string — REQUIRED
Responses
200

Tenant with that name already exists

Schema — OPTIONAL
id uuid
initial_provider string

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.

name string
201

Tenant created

Schema — OPTIONAL
id uuid
initial_provider string

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.

name string
403

Caller is not a platform owner

Schema — OPTIONAL
details

Detailed error metadata. The contents of this field is determined by error_code.

error_code string

Error code is a string that specifies this error type.

message string

Human-readable error message.

500
Schema — OPTIONAL
details

Detailed error metadata. The contents of this field is determined by error_code.

error_code string

Error code is a string that specifies this error type.

message string

Human-readable error message.