User Logout
API to logout the user from IAM and SSMS, ssms query parameter is to decide whether to logout the user from SSMS or not.
Resource Informations
| Name | Value |
|---|---|
| Requires authentication? | Yes |
| Rate limited? | No |
Request
Request headers
| Key | Value |
|---|---|
| Authorization | Bearer token |
| Content-Type | application/json |
HTTP request URL for SSMS
PUT https://{tenantId}.{hostname}/digitanium/v4/users/{userid}/logout?ssms=true
HTTP request URL for SHIFT
PUT https://{hostname}/auth/realms/{tenantId}/v3_user/{userid}/ssms/logout?ssms=true
note
At this moment, this API is applicable only for SSMS based installations.
note
API requests must be made over https. Calls made over plain http will fail.
Parameters
| Parameter Name | Type | Description |
|---|---|---|
| SSMS | Boolean | True - Enable, False - Disable |
Request body
No request body fields are required.
Response
| Field Name | Type | Description |
|---|---|---|
| message | String | The message explains the result of the API call. Refer to Response status Information for details. |
| status | String | The status of the API call. Refer Response status Information for details. |
| subSystem | Integer | subSystem categorizes the type of API that has been called. Refer Subsystem details for details. |
Sample Response
{
"message": "User logged out successfully",
"status": "Success",
"subSystem": 5
}
Response Status Information
| Status Code | Status | Message |
|---|---|---|
| 200 | Success | User logged out successfully. |
| 401 | Unauthorized | HTTP 401 Unauthorized. |
| 404 | USER_NOT_FOUND | User does not exist. |
| 409 | USER_ALREADY_LOGGED_OUT | User is not logged in state to perform this action. |