Skip to main content

Tenant

The Permissions Space Block is a multi-tenant system. This means that you can create multiple tenants and manage them independently from each other. Each tenant has its own set of resources, groups and user-defined roles.

Single tenant scenarios

In case your application is not multi-tenant or only needs a single tenant, you can create a single tenant called default and use it for all operations.

The tenant is always the top-level root resource of your resource-type hierarchy. Just like any other resource type, members and permissions can be defined on a tenant.

Manage tenants​

The Tenant API is used to manage tenants.

  • /tenants

Create a tenant​

curl -i --location "https://<YOUR_API_URL>/management/tenants" \
  --request POST \
  --header "Content-Type: application/json" \
  --header "Authentication: Bearer <YOUR_ACCESS_TOKEN>" \
  --header "apiKey: <YOUR_API_KEY>" \
  --data '{
    "id": "default",
    "name": "Default"
  }'