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. Fails with a conflict if the name is already taken.

Request Body REQUIRED
name string REQUIRED
Responses
201

Tenant created

Schema OPTIONAL
id uuid
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.

409

A tenant with that name already exists

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.