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. 

  • "application/json"
  • "application/xml"

If no parameter is set, XML is the default response given.

"application/xml"
Content Type
  • application/xml
  • application/json
"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  

 

 

Comments


0 Comments

Last Updated: Nov 08,2024