Category / Section
Terminating User Login Session using REST API in Bold BI
Published:
This article provides guidance on how to terminate a user login session in Bold BI using the REST API. The API requires client credentials (client ID and secret) for authentication.
Ending the active user session
To end the user’s session, you can use the following API endpoint. In the request URL, please pass the user id, username or email address of the user.
Method | URL |
---|---|
POST | /api/v2.0/users/{user_id/email/username}/end-session?sessionId={sessionId} |
Query Parameter
You have the option to terminate all active sessions of the user or specific sessions of the user. To terminate a specific session, you need to pass the session ID in the query parameter.
To obtain the active session, please refer to the Get user’s active session API.
Parameter Name | Type | Required | Comments |
---|---|---|---|
sessionId | Guid | No | The session ID of the user’s active session |
Authentication
To learn how to obtain the authentication token, please visit this link. You need to include the access token in the request header as follows:
Header Name | Header Value |
---|---|
Authorization | Bearer <access_token> |
Sample Request
Sample Response
{
"api_status": true,
"data": null,
"status": true,
"status_message": "The user session has ended successfully."
}
Response Codes
HTTP Status Code | Description | Message |
---|---|---|
401 | Unauthorized | - |
200 | OK | The user session has ended successfully. |