Sign in
Users

Get a user

Returns a user with details such as the email, username, and associated roles.

get/v2/users/{username}

Path parameters

usernamestring required

The username of the user to return. 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.

Response

A user.

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.21

  • c94fd099d78b11See 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 optional property to the response with the status

      response-optional-property-added

  • fca567a46b3a1See the full diff
    • ●

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

      response-property-enum-value-added