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.