Skip to main content

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

NameValue
Requires authentication?Yes
Rate limited?No

Request

Request headers

KeyValue
AuthorizationBearer token
Content-Typeapplication/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 NameTypeDescription
SSMSBooleanTrue - Enable, False - Disable

Request body

No request body fields are required.

Response

Field NameTypeDescription
messageStringThe message explains the result of the API call. Refer to 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": "User logged out successfully",
"status": "Success",
"subSystem": 5
}

Response Status Information

Status CodeStatusMessage
200SuccessUser logged out successfully.
401UnauthorizedHTTP 401 Unauthorized.
404USER_NOT_FOUNDUser does not exist.
409USER_ALREADY_LOGGED_OUTUser is not logged in state to perform this action.