Create a user in the current customer account

POST 
/v2/users

Create a user for the current customer account.

Request

Header Parameters

Request-Timeout integer

Possible values: >= 1

The API will make a best effort to complete the request in the specified seconds or time out.

Request-Timeout-Millis integer

Possible values: >= 1

The API will make a best effort to complete the request in the specified milliseconds or time out.

application/json

Body

email emailrequired

The email address for the user.

username string

The username for the user. The value defaults to the email.

description string

The description of the user.

api_roles ApiRole[]

Possible values: [owner, administrator, billing_administrator, corpus_administrator]

The role names assigned to the user.

Responses

201

The created user.

application/json

Schema

Schema

id string

Possible values: Value must match regular expression usr_.+

The Vectara ID for the user.

email email

The email address for the user.

username string

The username for the user.

enabled boolean

Indicates whether the user is enabled or disabled.

description string

The description of the user.

created_at date-time

When the user was created.

updated_at date-time

When a user property was last updated.

api_roles ApiRole[]

Possible values: [owner, administrator, billing_administrator, corpus_administrator]

The role names of the user.

api_policy object
What actions a principal can take on the Vectara platform.
name stringrequired
The name of the API role.
allowed_operations objectrequired
Operations that are allowed by the API role. Each operation may only allow certain resources that are described by a resource path to resource value map. If the value is null, then the operation is allowed on any resource.
property name* ApiOperationPolicy
Policy to allow operations if only using the specified resource.
allow_any_resource booleanrequired
Default value: true
If any resource is allowed for the operation.
allowed_resources object
Object with keys of resource paths to a list of allowed resources. A resource path starts with either body, path, or implicit. A body or path resource is within the operation body, and an implicit resource is a resource implied by the request.
property name* string[]
Array [
string
]

Example (from schema)

{
  "id": "string",
  "email": "user@example.com",
  "username": "string",
  "enabled": true,
  "description": "string",
  "created_at": "2024-12-13T17:52:53.644Z",
  "updated_at": "2024-12-13T17:52:53.644Z",
  "api_roles": [
    "owner"
  ],
  "api_policy": {
    "name": "string",
    "allowed_operations": {}
  }
}

400

User creation request was malformed.

application/json

Schema

Schema

field_errors object
The errors that relate to specific fields in the request.
property name* string
messages message[]
request_id string

The ID of the request that can be used to help Vectara support debug what went wrong.

Example (from schema)

{
  "field_errors": {},
  "messages": [
    "string"
  ],
  "request_id": "string"
}

403

Permissions do not allow retrieving a user.

application/json

Schema

Schema

messages message[]

The messages describing why the error occurred.

request_id string

The ID of the request that can be used to help Vectara support debug what went wrong.

Example (from schema)

{
  "messages": [
    "Internal server error."
  ],
  "request_id": "string"
}

Loading...