Skip to main content
Version: 4.18.1

Delete Tenant

Delete Tenant is used to delete a tenant, which was created using Create Tenant.

Resource Informations

Requires authentication?Yes
Rate limited?No


Request headers

AuthorizationBearer token

HTTP request URL for SSMS

DELETE https://{tenantId}.{hostname}/digitanium/v4/tenants/{tenantId}

HTTP request URL for SHIFT

DELETE https://{hostname}/auth/realms/{tenantId}/v3_realm/{tenantId}

API requests must be made over https. Calls made over plain http will fail. {tenantId} which is used in http request should be a master tenantId.


No parameter fields are required.

Request body

No request body fields are required.


Field NameTypeDescription
messageStringMessage explains result of the API call. Refer Response status Information for details.
statusStringThe status of the API call. Refer Response status Information for details.
subSystemIntegersubSystem categorizes the type of API that has been called. Refer Subsystem details for details.

Sample Response

"message": "Tenant deleted successfully",
"status": "OK",
"subSystem": 1

Response Status Information

Status CodeStatusMessage
200OKTenant deleted successfully
401UnauthorizedHTTP 401 Unauthorized
404TENANT_NOT_FOUNDTenant does not exist