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: Jun 10,2023