Start a new conversation
AuthorizationBearer <token>
Bearer token authentication:
Include your API token in the Authorization header:
Authorization: Bearer <your_token>
You will receive your token during onboarding.
In: header
Path Parameters
customer_slugstring
Your organization's unique identifier
promptstring
Question or instruction for the AI agent to process
datasourceIdstring
Identifier of the dataset to use
modelstring
AI model to use for processing
Default
"claude-sonnet-4-6"Value in
"gemini-2.5-flash" | "gemini-2.5-pro" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-opus-4-5" | "claude-opus-4-6"scopeScope
environment?string
Environment to run the query in
Default
"production"Value in
"production" | "testing"tags?Tags
Custom key-value metadata for filtering and organization. Set at conversation creation and immutable after.
Key constraints: 1–128 characters, must match ^[a-zA-Z][a-zA-Z0-9_-]*$ (start with a letter, then letters, digits, underscores, or hyphens). Keys are case-sensitive.
Value constraints: Strings only, max 512 characters.
Limit: Maximum 50 tags per conversation.
Properties
properties <= 50Empty Object
Response Body
curl -X POST "https://app.querio.ai/api/v2/embed/querio/conversations" \ -H "Content-Type: application/json" \ -d '{ "prompt": "How many shipments happened in the last 30 days?", "datasourceId": "ds_ship_123", "model": "claude-sonnet-4-6", "scope": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" }, "environment": "production", "tags": { "user_id": "usr_8f3a2b", "department": "logistics" } }'{
"conversationId": "conv_abc123xyz"
}{
"code": "invalid_client",
"message": "Authentication failed: invalid or expired token"
}{
"code": "querio_error",
"message": "Unexpected internal error"
}