Sign in
Users

Update a user

Updates details of a user such as role names.

patch/v2/users/{username}

Path parameters

usernamestring required

The username of the user to update. The username must be percent encoded.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Request body

enabledboolean

Indicates whether to enable or disable the user.

api_rolesApiRole[]

The new customer-level role names of the user.

descriptionstring

The description of the user.

metadataobject nullable

Arbitrary metadata associated with the user. Replaces the stored metadata entirely; it is not merged. Omit the field to leave it unchanged, or set it to null to clear it. The JSON serialization must not exceed 65535 bytes; larger payloads are rejected with a 400 response.

Example request

{
  "metadata": {
    "console_mode": "business"
  }
}

Response

The user after the update.

idstring required

The Vectara ID for the user.

emailstring email required

The email address for the user.

usernamestring

The username for the user.

enabledboolean

Indicates whether the user is enabled or disabled.

descriptionstring

The description of the user.

created_atstring date-time

When the user was created.

updated_atstring date-time

When a user property was last updated.

api_rolesApiRole[]

The customer-level role names of the user.

metadataobject

Arbitrary metadata associated with the user.

Example response

{
  "metadata": {
    "console_mode": "business"
  }
}

Changes

Changed in 2 of the 13 revisions of this API.26

  • c94fd099d78b15See the full diff
    • ●

      added the new metrics_viewer enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new metrics_viewer enum value to the request property /

      request-property-enum-value-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • fca567a46b3a11See the full diff
    • ●

      added the new agent_end_user enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new agent_end_user enum value to the request property //

      request-property-enum-value-added