Skip to main content

Creates a tenant

POST 

/iam/tenants

Creates a new tenant to be used in the policies that control permissions.

A tenant defines the scope of resources in a policy statement. Resources can be in more than one tenant.

When a tenant is created, the system also creates three policies associated with the new tenant, one for each of the following roles: editor, viewer, and tenant admin. You can optionally pass the skip_policies flag set to true to skip the creation of these policies.

Authorization Action:

iam:tenants:create

Request

Body

required
    id stringrequired

    Unique ID. Cannot be changed.

    name stringrequired

    Name for the new tenant.

    skipPolicies boolean

    Boolean flag to skip adding policies associated with the tenant. Set to false by default.

Responses

A successful response.

Schema
    tenant object
    name string

    Name for the tenant.

    id string

    Unique ID. Cannot be changed.

    type compiuta.api.iam.v2.Type

    Possible values: [COMPIUTA_MANAGED, CUSTOM]

    Default value: COMPIUTA_MANAGED

Loading...