Quintus

https://quintus.tec.br/docs
Admin
Quintus is a centralized generative AI platform for enterprises that unifies access to multiple AI...
Tokens:3,359
Snippets:51
Trust Score:2.7
Update:5 months ago
Show doc for...
Tokens:
Raw
### Create Agent Session

Source: https://quintus.tec.br/docs/pt-BR/public/api/agents/authentication

Example of how to authenticate a call to create an agent session using the `X-API-Key` header.

```APIDOC
## Create Agent Session

### Description
Authenticates a request to create a new agent session.

### Method
`POST`

### Endpoint
`/v1/agent/sessions`

### Headers
- `X-API-Key`: `qts-sk-...` (Your private API key)

### Request Example
```bash
curl https://api.quintus.tec.br/v1/agent/sessions \
  -H "X-API-Key: SUA_API_KEY"
```

### Response
#### Success Response (200)
Details of the created session (schema not provided in source).

#### Response Example
(Example not provided in source)
```

--------------------------------

### Autenticação com Chave de API

Source: https://quintus.tec.br/docs/pt-BR/public/api/agents/authentication

Todas as chamadas para a API de agentes requerem o header `X-API-Key` com sua chave privada no formato `qts-sk-...`. Crie ou gerencie suas chaves em app.quintus.tec.br/settings/api-keys.

```bash
curl https://api.quintus.tec.br/v1/agent/sessions \
  -H "X-API-Key: SUA_API_KEY"
```

--------------------------------

### User Response Schema

Source: https://quintus.tec.br/docs/api-reference/users/create-user

Defines the structure of a User object returned by the API.

```APIDOC
## UserResponse

### Description
Represents a user in the system.

### Properties
- **id** (string) - Required - Unique identifier for the user.
- **reference** (string | null) - Optional - External reference identifier for the user.
- **name** (string | null) - Optional - The name of the user.
- **email** (string | null) - Optional - The email address of the user.
- **phone** (string | null) - Optional - The phone number of the user.
- **metadata** (object | null) - Optional - Additional metadata associated with the user.
- **info** (object | null) - Optional - General information about the user.
- **created_at** (string) - Required - Timestamp when the user was created (ISO 8601 format).
- **updated_at** (string) - Required - Timestamp when the user was last updated (ISO 8601 format).
```

--------------------------------

### Error Envelope Schema

Source: https://quintus.tec.br/docs/api-reference/users/create-user

Defines the structure for error responses from the API.

```APIDOC
## ErrorEnvelope

### Description
Standard envelope for API error responses.

### Properties
- **error** (object) - Required - Contains details about the error.
  - **code** (string) - Required - Stable machine-readable error code (snake_case).
  - **name** (string) - Required - Error class name (PascalCase).
  - **message** (string) - Required - Human-readable explanation of the error.
  - **context** (object) - Optional - Error-specific structured context (ids, limits, hints).
- **request_id** (string | null) - Optional - Request ID for support correlation.
- **timestamp** (string | null) - Optional - ISO-8601 server timestamp when the error occurred.
```

--------------------------------

### HTTP Validation Error Schema

Source: https://quintus.tec.br/docs/api-reference/users/create-user

Defines the structure for validation errors in HTTP requests.

```APIDOC
## HTTPValidationError

### Description
Structure for detailed validation errors in HTTP requests.

### Properties
- **detail** (array) - Required - A list of validation errors.
  - Each item in the array is a ValidationError object:
    - **loc** (array) - Required - Location of the error in the request (e.g., field name, index).
    - **msg** (string) - Required - Human-readable error message.
    - **type** (string) - Required - Type of validation error.
```
Tokens:
Raw