Create an App Client

POST 
https://api.vectara.io/v2/app_clients

An App Client is used for OAuth 2.0 authentication when calling Vectara APIs.

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

oneOf

CreateClientCredentialsRequest

name stringrequired

Name of the client credentials.

description string

Description of the client credentials.

type stringrequired

Default value: client_credentials

This will always be the value client_credentials.

api_roles ApiRole[]

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

API roles that the client credentials will have.

Responses

201

An App Client object, used to query the Vectara API with the assigned roles.

application/json

Schema

Schema

id string

Possible values: Value must match regular expression app_.+$

The Vectara App Client ID. This ID is not used during an OAuth flow. However, the ID used within the Vectara API.

name string

The human-readable name of the App Client.

description string

Description of the App Client.

client_id string

The client ID used with the OAuth flow.

client_secret string

The client secret used in API requests. The secret should be kept secure.

api_roles ApiRole[]

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

The API roles attached to the App Client.

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",
  "name": "string",
  "description": "string",
  "client_id": "string",
  "client_secret": "string",
  "api_roles": [
    "owner"
  ],
  "api_policy": {
    "name": "string",
    "allowed_operations": {}
  }
}

400

App Client 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 creating the App Client.

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"
}

Authorization: x-api-key

name: x-api-keytype: apiKeyin: header

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'https://api.vectara.io/v2/app_clients' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'x-api-key: <API_KEY_VALUE>' \
--data-raw '{
  "name": "string",
  "description": "string",
  "type": "client_credentials",
  "api_roles": [
    "owner"
  ]
}'

Request Collapse all

Base URL

https://api.vectara.io

Auth

Security Scheme

ApiKeyAuthOAuth2

ApiKeyAuth

Parameters

Request-Timeout — header

Request-Timeout-Millis — header

Body

{
  "name": "string",
  "description": "string",
  "type": "client_credentials",
  "api_roles": [
    "owner"
  ]
}

ResponseClear

Click the Send API Request button above and see the response here!