/
REST Objects Tenant

REST Objects Tenant

5.0.0 ?.?.?

Tenant objects are used to represent tenants (entities, accounts) in the multi-tenant ServiceBroker system.  

On this page:

Related pages:

Tenant Object Format

Unable to render {include} The included page could not be found.

Tenant Object Properties


PropertyTypeRequired?Description
EntityIdstringNo

The GUID string by which the Tenant is identified.

The EntityId is not a required field, and when a Tenant is created, if not supplied, an EntityId will be automatically generated.

However, if the Tenant is to be integrated with ServiceMobility, then the EntityId field must match the ID of the entity in ServiceMobility with which the Tenant is to be associated.

NamestringYesA string describing the name of the Tenant.
EmailstringYesAn email address which can be used to communicate with the owner(s) of the Tenant.
ExtSysIdstringNoAn optional ID from an external system, if an association between an account in an external system and the Tenant should be noted.
DescstringNoA string describing the Tenant in more detail, if the Name field is insufficient.
ActivebooleanNoIndicates if the Tenant is active or not. Defaults to true.
SIDstringNo

A globally unique identifier for the Tenant, which is used internally by ServiceBroker.

The SID field can not be set on creation/update - it is an internal identifier only.

DomainstringNo

A short, human readable customer identification string, used when a single customer has multiple Tenants.

When multiple Tenants have the same Domain field, it allows customers using ServicePower's Next Generation Gantt to switch between associated Tenants.

CreatedAtdatetimeNo

A date/time value representing when the Tenant was created.

The CreatedAt field can not be set on creation/update - it is an internal field only.

AuthTypestringNo

Defines the type of authentication for the Tenant. Options are:

When not supplied, the Tenant will be configured to authenticate via System Access Tokens.

This parameter can only be supplied when creating a new Tenant object via the POST /up/v5/entity operation.

Once the Tenant object has been created, the authentication method cannot be updated.

Related content

REST Objects System Access Token
REST Objects System Access Token
More like this
REST Tenant Management
REST Tenant Management
More like this
REST Objects Configuration
REST Objects Configuration
More like this
REST Objects Providers
REST Objects Providers
More like this