Transfer User

POST https://{server_address}/api/v1/organization/users/transfer

Transfer the user to a specific organization.

Headers

Name	Value
Authorization*	Bearer {access_token}
Content-Type*	application/json

Request Body

Name	Example	Description
userId*	1	The identifier of the user, which should be transferred, integer.
targetOrgId*	2	The identifier of the destination organization, integer.
roleId*	3	New user's role identifier, integer.

201: User transfered

{
   "id": 1078,
   "name": "John Doe",
   "email": "[email protected]",
   "title": "John",
   "nickName": "john",
   "phoneNumber": "[phone]",
   "roleId": 3,
   "orgId": 703,
   "tz": "Europe/Kiev",
   "locale": "en_US",
   "status": "Active",
   "lastModifiedTs": 1702985292062,
   "lastLoggedAt": 1702985292062,
   "registeredAt": 1702985292062,
   "isDev": false
}

404: Organisation is not found

400: Role is not found

400: User is not found

Request examples:

# curl command example:
$ curl -X POST -H "Content-Type: application/json" \
      -H "Authorization: Bearer {accessToken}" \
      -d '{"userId":1,"targetOrgId":1,"roleId":1}' \
      https://fra1.blynk.cloud/api/v1/organization/users/transfer

$ curl -X POST -H "Content-Type: application/json" \
      -H "Authorization: Bearer eIdWHQqRfFmvP5LDDh-IGxPUzi7I27HthzCPAVmS" \
      -d '{"userId":1,"targetOrgId":1,"roleId":1}' \
      https://fra1.blynk.cloud/api/v1/organization/users/transfer