Update User
Use PUT method to update an existing User. To update a User, inquire a source User data packet via GET method and pass it with the PUT method.
Change parameters’ values you wish to override.
Endpoint:
PUT
.../api/users
Request Parameters
NOTE:
Optional fields can be manually removed from the request in case you want to skip them.
Enter valid parameters values in case you want to pass them in the request. Please note that in case a parameter is not sent or sent without any value the parameter field will be empty.
Response Codes
| Name | Type | Optionality | Description | |||||||||||||||||||||||||||
| id | integer | ✓ | System user identifier. | |||||||||||||||||||||||||||
| operatorId | integer | Operator identifier.
Required for operator manager/api operator manager. |
||||||||||||||||||||||||||||
| serviceProviderId | integer | Service Provider identifier. Serves as SkinID for user authorization purposes. Required for all Back-Office Users/ API Users. | ||||||||||||||||||||||||||||
| userName | string | ✓ | Username.
Maxlength(20)
Special characters ” and \ must be placed as \” and \\
|
|||||||||||||||||||||||||||
| firstName | string | ✓ | User first name.
MaxLength(100)
Special characters ” and \ must be placed as \” and \\
|
|||||||||||||||||||||||||||
| lastName | string | ✓ | User last name.
MaxLength(100)
Special characters ” and \ must be placed as \” and \\
|
|||||||||||||||||||||||||||
| string | ✓ | User contact email address.
MaxLength(50) |
||||||||||||||||||||||||||||
| phone | string | ✓ | User contact phone number.
MaxLength(50) |
|||||||||||||||||||||||||||
| userRole | integer | User role.
Available Values:
|
||||||||||||||||||||||||||||
| addAllAccounts | bool | Set true to grand your user permissions to all available Platform Accounts. Set false and list Platform Accounts and Sub-Accounts you wish your user to get access to. | ||||||||||||||||||||||||||||
| accounts | object | Available Platform Accounts and Sub-Accounts for this user. | ||||||||||||||||||||||||||||
| isMfaEnabled | bool | optional | Parameter that indicates using of the Multi-factor Authentication functionality. |
| Response Code | Description |
|---|---|
| 200 | Ok |
| 201 | Created — User has been created successfully. |
| 400 | Bad Request — Your request is invalid. |
| 401 | Unauthorized — Authorization failed. |
| 403 | Forbidden — Access denied. |
| 404 | Not Found — Wrong URL. |
| 415 | Unsupported Media Type — Wrong request format. |
| 500 | Internal Server Error — We had a problem with our server. Try again later. |
| 503 | Service Unavailable — We’re temporarily offline for maintenance. Please try again later. |
{
"id": 0,
"operatorId": 0,
"serviceProviderId": 0,
"userName": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"phone": "string",
"userRole": 0,
"addAllAccounts": false,
"accounts": [
{
"accountId": 0,
"subAccounts": [
0
]
}
],
"isMfaEnabled": true
},
{
"id": 0,
"operatorId": 0,
"serviceProviderId": 0,
"userName": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"phone": "string",
"userRole": 0,
"addAllAccounts": true,
"accounts": [],
"isMfaEnabled": true
}
Response
{
"id": 123,
"name": "userName"
}