AVAILABLE WITH BUSINESS SUBSCRIPTION
Request: POST /user/{user_id}/status
Permissions to Run the Request
Account Owner, Account Administrators, Department Administrators, or custom roles.
Department Administrators and users with a custom role may activate or deactivate only users belonging to the departments they manage or their subdepartments.
Course authors do not have access to the methods or data involved in requesting user information.
Request Headers
| |
|---|
| Authorization (required) | Access token. You can obtain a token by making a request |
| Parameter | Description |
|---|
| user_id (required) | The ID of a user you want to activate or deactivate |
| status | To block a user, add 3 (<status>3</status>) in the status row. To active a user, type 1 (<status>1</status>) To end user employment, use 5 in the status row (<status>5</status>). |
Possible Response Codes
Code | Text | Description |
|---|
| 200 | OK | A user's status is changed |
| 400 | Bad Request | A request error |
| 401 | Unauthorized | An authorization error |
| 403 | Permission Denied | The user doesn't have enough permissions to activate or deactivate users. For example, Department Administrators can't activate or deactivate users who don't belong to the departments they manage |
Sample Request
POST /user/43f4a84c-6280-11e9-8686-a6210366ac32/status https/1.1
Host: api-learn.ispringlearn.com
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8"?>
<request>
<status>1</status>
</request>
XML
Sample Response