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

Updates the username of the specified Interactive User. This API call can be made by either the Administrator who created the target user or the target user themselves.

Request Information

Parameters

NameDescriptionAdditional information
id
The identifier of the target user.

Define this parameter in the request URI.

newUsername
The email address which will become the user's username.

Define this parameter in the request body.

Request body formats

application/json, text/json

Sample:
{
  "Username": "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 username must be less than 255 characters and unique, 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": "18d87b82-1e0c-407d-bb78-b94290ae0195",
  "Name": "sample string 2",
  "Username": "sample string 3",
  "Role": "sample string 4",
  "Credentials": [
    {
      "Id": "e175aade-b6a0-4281-aff8-1ab2d96b09db",
      "Enabled": true,
      "Created": "2020-07-06T04:53:12.976912+00:00"
    },
    {
      "Id": "e175aade-b6a0-4281-aff8-1ab2d96b09db",
      "Enabled": true,
      "Created": "2020-07-06T04:53:12.976912+00:00"
    },
    {
      "Id": "e175aade-b6a0-4281-aff8-1ab2d96b09db",
      "Enabled": true,
      "Created": "2020-07-06T04:53:12.976912+00:00"
    }
  ],
  "Enabled": true,
  "Created": "2020-07-06T04:53:12.976912+00:00"
}