Update a User

Updates the specified user by passing new values in the request body. Only Groupkey, Role, Type and Team Attributes fields can be updated.

🚧

Note

  • To update 'TeamAttributes', you must provide en entire list of team attributes and corresponding values. If you pass only attributes that you want to update, all other attributes, which are not provided, will be deleted.
  • To delete all attributes, pass TeamAttributes parameter with an empty array/hash.\
    {
    "TeamAttributes": []
    }\

The following are the examples of HTTP status codes including errors that API can generate

Response codes

Response content

Description

200 OK

A user has been updated successfully.

400 Bad Request

Invalid user type: "IncorrectType"

The 'Type' parameter that was specified is invalid.

400 Bad Request

Invalid user role:"IncorrectRole"

The 'Role' parameter that was specified is invalid.

400 Bad Request

Clients is not available

You need the 'Clients' feature to be enabled for your account to create a new client.

400 Bad Request

CanCreate is not available for admins

'CanCreate' parameter is not allowed for users with 'Admin' role. Admins have full access by default.

400 Bad Request

CanCreate is not available for clients

'CanCreate' parameter is not allowed for users of type 'Client'. Clients have read only access.

400 Bad Request

Incorrect user Type

The 'Type' parameter that was specified doesn't match the corresponding group UserType .

400 Bad Request

Attribute not found, Key=112

A team attribute wasn't found.

403 Forbidden

Access denied

You can't update a user with 'Owner role.

404 Not Found

Object not found

A user with the specified key was not found.

Language
Credentials
Click Try It! to start a request and see the response here!