User APIs
Update user(s) status
OVERVIEW
NOTE : This API endpoint is supported in version 5.0 onwards.
Overview
This API call is used to update the status of the users given in the request body. The three status types are allowed - Active,Inactive and Anonymise.
HTTP Request
PUT /api/4/users?status=inactive/active/anonymise
HTTP Request Object
Request xml
<users>
<user>
<userid>102</userid>
<userid>101</userid>
</user>
</users>
Request JSON
{
"user": {
"userid": [
"102",
"101"
]
}
}
HTTP Headers
HTTP Request Header | Description | Example |
---|---|---|
Authorization | The API Authorisation token | "Bearer XXXXXXXXXXXXX" |
Accept |
The format of the expected response.
If no parameter is set, XML is the default response given. |
"application/xml" |
Content Type |
|
"application/xml" |
HTTP Response
Success
HTTP response 200
Example HTTP Request & Response
PUT http://example.com/context/api/4/users?status=inactive
Error messages
Summary | Ref Code (V4) | Ref Code (before V4) |
A User ID is required | 109 | |
The following users do not exist within the system | 110 | |
The given action cannot be performed on anonymised user(s). | 325 | |
User ID is not in proper format | 113 | |
You can only anonymise a user who has been archived. The following users are not archived | 347 | |
This status is invalid. Please use either Active, Inactive or Anonymise | 346 |
Last Updated: Nov 08,2024
Comments
0 Comments