Start a conversation

Authorization

bearerAuth

AuthorizationBearer <token>

Include your API token in the Authorization header:

Authorization: Bearer <token>

Tokens are created in the Querio workspace settings under Embedded > API Tokens.

In: header

Path Parameters

customer_slug*string

Customer slug that maps to a workspace and agent configuration.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

prompt*string

The user's question.

datasourceSlug*string

Datasource slug to query against.

datasourceId?string

Previous name for the datasource. Still accepted when datasourceSlug is omitted.

model*string

AI model ID.

Default"claude-sonnet-5-5"

Value in

"claude-sonnet-5-5"
"claude-opus-5-5"
"claude-haiku-4-5"
"gemini-2.5-pro"
"gemini-3.5-flash"
"gpt-6.1-sol"
"gpt-6-luna"
"claude-sonnet-5"
"claude-sonnet-4-6"
"claude-opus-5"
"gpt-5.6-terra"
"gpt-5.6-sol"
"gpt-5.6-luna"

scope?

Runtime scope variables such as customer_id used for RLS.

environment?string

Environment label for filtering.

tags?

Key-value tags for filtering and grouping conversations.

Response Body

`application/json`

curl -X POST "https://example.com/v2/embed/dunder-mifflin/conversations" \  -H "Content-Type: application/json" \  -d '{    "prompt": "Show me the last 10 orders",    "datasourceSlug": "orders",    "model": "claude-sonnet-5",    "scope": {      "customer_id": "acme-corp"    },    "environment": "production",    "tags": {      "team": "sales",      "source": "app"    }  }'

{  "conversationId": "38770bb6-b14b-405c-aed6-71e8849c77dc"}

{  "error": "Unsupported model",  "message": "Model ID not in supported list"}

{  "error": "Missing or invalid Authorization header",  "message": "No Bearer token or invalid token"}

{  "error": "Token does not have access to this consumer",  "message": "Token workspace does not match consumer"}

{  "error": "Unknown consumer",  "message": "Customer slug not configured"}

Authorization

Path Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

Example missing_or_invalid

Example invalid_token

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`