TenantsApi
| Method | HTTP request | Description |
|---|---|---|
| CreateTenantAsyncUsingPOST | POST /api/web/v5/async/tenants | Create a tenant asynchronously |
| CreateTenantUsingPOST | POST /api/web/v4/tenants | Create a tenant |
| DeleteTenantEntitlementUsingDELETE | DELETE /api/web/v4/tenants/{tenantid}/entitlements/{type} | Delete an entitlement |
| GetCreateTenantAsyncResultUsingGET | GET /api/web/v4/async/tenants/{id}/createresult | Get the result of an asynchronous tenant creation operation |
| GetCreateTenantAsyncStatusUsingGET | GET /api/web/v4/async/tenants/{id}/createstatus | Get the status of an asynchronous tenant creation operation |
| GetEntitlementUsageInfoUsingPOST | POST /api/web/v4/tenants/entitlements/usage | Lists a page of entitlement usage information |
| GetSpIdentityProviderUsingGET | GET /api/web/v1/tenants/{id}/spidentityprovider | Get Tenant Identity Provider and Service Provider OIDC Application for Tenant Management. |
| GetTenantEntitlementUsingGET | GET /api/web/v4/tenants/{tenantid}/entitlements/{type} | Get an entitlement |
| GetTenantEntitlementsUsingGET | GET /api/web/v4/tenants/{tenantid}/entitlements | Get entitlements for tenant |
| GetTenantUsingGET | GET /api/web/v4/tenants/{id} | Get a tenant |
| GetTenantsPageUsingPOST | POST /api/web/v4/tenantspaged | Lists a page of tenants |
| LockTenantUsingPUT | PUT /api/web/v4/tenants/{id}/lock | Lock a tenant |
| RemoveTenantUsingDELETE | DELETE /api/web/v4/tenants/{id} | Delete a tenant |
| SetSpIdentityProviderUsingPUT | PUT /api/web/v1/tenants/{id}/spidentityprovider | Set Tenant Identity Provider and Service Provider OIDC Application for Tenant Management |
| SetTenantEntitlementUsingPUT | PUT /api/web/v4/tenants/{tenantid}/entitlements | Set an entitlement |
| UnlockTenantUsingPUT | PUT /api/web/v4/tenants/{id}/unlock | Unlock a tenant |
CreateTenantAsyncUsingPOST
CreateTenantAsyncStatus CreateTenantAsyncUsingPOST (CreateTenantParms createTenantParms)
Create a tenant asynchronously
Create a new tenant for a service provider. Caller requires the TENANTS:ADD permission from a service provider role.
Notes on CreateTenantParms attributes:
adminUser (UserParms):- The locale attribute is ignored if provided. It defaults to English for the first super administrator.
- The status attributes is ignored if provided. It defaults to ACTIVE for the first super administrator.
- The userId is required.
adminApiApplication (AdminApiApplicationParms):
- The spRoleId attribute is not supported. An error is returned if provided.
entitlements (EntitlementParms):
- The contractMode attribute is required. It must be either TRIAL or PRODUCTION.
- The quantity attribute is required.
- entitlements.issuance (EntitlementParms.IssuanceParms):
- The entitlements.issuance attribute is required if you are creating an Issuance tenant.
- The serviceBundles attribute is required. One service bundle (of those supported by the service provider contract) must be defined.
Using the CreateTenantAsyncUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| createTenantParms | CreateTenantParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
CreateTenantUsingPOST
CreateTenantResult CreateTenantUsingPOST (CreateTenantParms createTenantParms)
Create a tenant
Create a new tenant for a service provider. Caller requires the TENANTS:ADD permission from a service provider role.
Notes on CreateTenantParms attributes:
adminUser (UserParms):
- The locale attribute is ignored if provided. It defaults to English for the first super administrator.
- The status attributes is ignored if provided. It defaults to ACTIVE for the first super administrator.
- The userId is required.
adminApiApplication (AdminApiApplicationParms):
- The spRoleId attribute is not supported. An error is returned if provided.
entitlements (EntitlementParms):
- The contractMode attribute is required. It must be either TRIAL or PRODUCTION.
- The quantity attribute is required.
- entitlements.issuance (EntitlementParms.IssuanceParms):
- The entitlements.issuance attribute is required if you are creating an Issuance tenant.
- The serviceBundles attribute is required. One service bundle (of those supported by the service provider contract) must be defined.
Example
Using the CreateTenantUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| createTenantParms | CreateTenantParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
DeleteTenantEntitlementUsingDELETE
void DeleteTenantEntitlementUsingDELETE (string tenantid, string type)
Delete an entitlement
Delete the entitlement for the specified tenant. Caller requires the SPENTITLEMENTS:REMOVE permission from a service provider role.
Example
Using the DeleteTenantEntitlementUsingDELETEWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| tenantid | string | The UUID of the tenant whose entitlement is to be deleted. | |
| type | string | The type of entitlement. Allowed values: SMSVOICE. |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetCreateTenantAsyncResultUsingGET
CreateTenantResult GetCreateTenantAsyncResultUsingGET (string id)
Get the result of an asynchronous tenant creation operation
Get the result of a tenant creation operation for a service provider. The results for a given operation can only be retrieved once. Caller requires the TENANTS:ADD permission from a service provider role.
Example
Using the GetCreateTenantAsyncResultUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the create tenant operation whose results are to be fetched. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetCreateTenantAsyncStatusUsingGET
CreateTenantAsyncStatus GetCreateTenantAsyncStatusUsingGET (string id)
Get the status of an asynchronous tenant creation operation
Get the status of a tenant creation operation for a service provider. Caller requires the TENANTS:VIEW permission from a service provider role.
Example
Using the GetCreateTenantAsyncStatusUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the create tenant operation whose status is be fetched. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetEntitlementUsageInfoUsingPOST
UsageInfoPage GetEntitlementUsageInfoUsingPOST (SearchParms searchParms)
Lists a page of entitlement usage information
Returns tenant usage information for the provided search parameters. Caller requires the TENANTS:VIEW permission. The following searchByAttributes are supported:
- startTime: a mandatory String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.
- endTime: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.
- tenantId: The UUID of the tenant. Allowed operators are: EQUALS.
- isTrial: true or false. Allowed operator: EQUALS.
- usageType: the type of entitlement: USERS, ISSUANCE. Allowed operator: EQUALS.
The orderByAttribute supports these attribute names: startTime.
Example
Using the GetEntitlementUsageInfoUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| searchParms | SearchParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetSpIdentityProviderUsingGET
SpIdentityProvider GetSpIdentityProviderUsingGET (string id)
Get Tenant Identity Provider and Service Provider OIDC Application for Tenant Management.
Get Tenant Identity Provider and Service Provider OIDC Application for Tenant Management. Caller requires the SPIDENTITYPROVIDERS:VIEW permission.
Example
Using the GetSpIdentityProviderUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the tenant to be obtained. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetTenantEntitlementUsingGET
Entitlement GetTenantEntitlementUsingGET (string tenantid, string type)
Get an entitlement
Get the specified entitlement for a tenant. Caller requires the SPENTITLEMENTS:VIEW permission from a service provider role.
Example
Using the GetTenantEntitlementUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| tenantid | string | The UUID of the tenant whose entitlement is to be fetched. | |
| type | string | The type of entitlement (only USERS is supported). |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetTenantEntitlementsUsingGET
List<Entitlement> GetTenantEntitlementsUsingGET (string tenantid)
Get entitlements for tenant
Get all entitlements for the specified tenant of the current service provider. Caller requires the SPENTITLEMENTS:VIEW permission from a service provider role.
Example
Using the GetTenantEntitlementsUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| tenantid | string | The UUID of the tenant whose entitlements are to be fetched. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetTenantUsingGET
Tenant GetTenantUsingGET (string id)
Get a tenant
Get the specified tenant for a service provider. Caller requires the TENANTS:VIEW permission from a service provider role.
Example
Using the GetTenantUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the tenant to be fetched. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetTenantsPageUsingPOST
TenantsPage GetTenantsPageUsingPOST (SearchParms searchParms)
Lists a page of tenants
Returns tenants for the provided search parameters. Caller requires the TENANTS:VIEW permission. The following searchByAttributes are supported:
- hostname: a String up to 100 characters. Allowed operators are: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS, STARTS_WITH, ENDS_WITH.
- companyName: a String up to 100 characters. Allowed operators are: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS, STARTS_WITH, ENDS_WITH.
- contractMode: PRODUCTION, TRIAL, UNKNOWN. Allowed operator: EQUALS.
- locked: true or false. Allowed operator: EQUALS.
- serviceProvider: true or false. Allowed operator: EQUALS.
- authenticationAccount: true or false. Allowed operator: EQUALS.
- issuanceAccount: true or false. Allowed operator: EQUALS.
- spIdp: true or false. Allowed operator: EQUALS.
The orderByAttribute supports these attribute names: hostname, companyName, contractMode, locked, serviceProvider, authenticationAccount, issuanceAccount, spIdp.
Example
Using the GetTenantsPageUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| searchParms | SearchParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
LockTenantUsingPUT
void LockTenantUsingPUT (string id)
Lock a tenant
Lock the specified tenant for a service provider. Caller requires the TENANTS:EDIT permission from a service provider role.
Example
Using the LockTenantUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the tenant to be locked. |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
RemoveTenantUsingDELETE
void RemoveTenantUsingDELETE (string id)
Delete a tenant
Delete the specified tenant for a service provider. Caller requires the TENANTS:REMOVE permission from a service provider role.
Example
Using the RemoveTenantUsingDELETEWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the tenant to be removed. |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
SetSpIdentityProviderUsingPUT
SpIdentityProvider SetSpIdentityProviderUsingPUT (string id, SpIdentityProviderParms spIdentityProviderParms)
Set Tenant Identity Provider and Service Provider OIDC Application for Tenant Management
Set Tenant Identity Provider and Service Provider OIDC Application for Tenant Management. Caller requires the SPIDENTITYPROVIDERS:EDIT permission.
Example
Using the SetSpIdentityProviderUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the tenant to be updated. | |
| spIdentityProviderParms | SpIdentityProviderParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
SetTenantEntitlementUsingPUT
void SetTenantEntitlementUsingPUT (string tenantid, EntitlementParms entitlementParms)
Set an entitlement
Set the entitlement for the specified tenant. Caller requires the SPENTITLEMENTS:EDIT permission from a service provider role.
Example
Using the SetTenantEntitlementUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| tenantid | string | The UUID of the tenant whose entitlement is to be set. | |
| entitlementParms | EntitlementParms |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
UnlockTenantUsingPUT
void UnlockTenantUsingPUT (string id)
Unlock a tenant
Unlock the specified tenant for a service provider. Caller requires the TENANTS:EDIT permission from a service provider role.
Example
Using the UnlockTenantUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the tenant to be unlocked. |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |