Start AI agent runs
AuthorizationBasic <token>
Basic Authentication using client credentials:
- Username:
client_id(provided during onboarding) - Password:
client_secret(shared once, never expires)
Format: Authorization: Basic <base64(client_id:client_secret)>
Example: If your client_id is "myapp_123" and client_secret is "secret_abc", encode "myapp_123:secret_abc" in base64.
In: header
Path Parameters
customer_slugstring
Your organization's unique identifier
promptstring
Instruction or question for the AI agent to process
dataset_idstring
Identifier of the dataset to use
scopeobject
environment?string
Environment to run the query in
Default
"production"Value in
"production" | "testing"Response Body
curl -X POST "https://server.prod.querio.ai/v1/embed/querio/runs" \ -H "Content-Type: application/json" \ -d '{ "prompt": "How many shipments happened in the last 30 days", "dataset_id": "ds_ship_123", "scope": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" }, "environment": "production" }'{
"runId": "cku9m0u1p0001abcxyz"
}{
"code": "invalid_request",
"message": "Client authentication failed: missing or invalid Authorization header"
}{
"code": "querio_error",
"message": "Unexpected internal error"
}