User status API endpoints
Updated March 13, 2020
Use this guide to to retrieve end user statuses through the SecureAuth Identity Management API and to check the status of end users, unlock locked-out users, disable users, and more.
To receive detailed statuses from Active Directory, you must enable the Advanced AD User Check option in the SecureAuth Identity Platform Data tab. If the option is disabled, you will receive incorrect statuses.
Prerequisites
Install the SecureAuth® Identity Platform version 19.07.01 with hotfix 19.07.01-8.
Complete the steps in "Prerequisites" in the Identity Management API guide.
In the "Workflow" section of the Identity Management API guide, when you complete step 2, return to this document.
GET endpoint
The /users/<userId>/status GET endpoint retrieves user status. SecureAuth Identity Platform accesses and retrieves the user's status from the username in the endpoint URL and returns a response.
HTTP Method | URI | Example | Identity Platform version |
---|---|---|---|
GET |
| https://secureauth.company.com/api/v2/users/jsmith/status | Hotfix version 19.07.01-8 |
POST endpoint
The POST method invokes a status to the user Id.
HTTP Method | URI | Example | Identity Platform version |
---|---|---|---|
POST |
| https://secureauth.company.com/api/v2/users/jsmith/status | Hotfix version 19.07.01-8 |