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. |