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 daughter departments.
Request Headers
Header | Description |
|---|---|
| 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
| Code Block | ||
|---|---|---|
| ||
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> |
Sample Response
| Code Block | ||
|---|---|---|
| ||
https/1.1 200 OK |