POST v2/api/users/{id}/name

Updates the name of the specified Interactive User to another valid name. This API call can be made by either the Administrator who created the target user or the target user themselves, otherwise a 403:Forbidden is returned.

Request Information

Parameters

NameDescriptionAdditional information
id
The identifier of the target user.

Define this parameter in the request URI.

newName
The new name.

Define this parameter in the request body.

Request body formats

application/json, text/json

Sample:
{
  "Name": "sample string 1"
}

Response Information

The newly updated Interactive User with their API Credentials is returned. This endpoint can only be called by neither the Administrator who created the target user or the target user themselves, otherwise a 403:Forbidden is returned. The user's name must less than 255 characters, otherwise a 400:BadRequest is returned. If the target user is disabled a 400:BadRequest is returned.

Response body formats

application/json, text/json

Sample:
{
  "Id": "639c0424-44fa-4f25-981c-244844ae8e9e",
  "Name": "sample string 2",
  "Username": "sample string 3",
  "Role": "sample string 4",
  "Credentials": [
    {
      "Id": "f965445f-739b-4feb-bf14-d5b2ad332540",
      "Enabled": true,
      "Created": "2020-07-06T04:27:17.9363197+00:00"
    },
    {
      "Id": "f965445f-739b-4feb-bf14-d5b2ad332540",
      "Enabled": true,
      "Created": "2020-07-06T04:27:17.9363197+00:00"
    },
    {
      "Id": "f965445f-739b-4feb-bf14-d5b2ad332540",
      "Enabled": true,
      "Created": "2020-07-06T04:27:17.9363197+00:00"
    }
  ],
  "Enabled": true,
  "Created": "2020-07-06T04:27:17.9363197+00:00"
}