Authentication
Basic Authentication for the v1 Runs API
Basic Authentication
All v1 endpoints require Basic Authentication using your client credentials:
- Username: Your
client_id(provided during onboarding) - Password: Your
client_secret(shared once, permanent)
Authorization: Basic <base64(client_id:client_secret)>Encoding Your Credentials
Base64-encode the string client_id:client_secret. For example, if your client_id is myapp_123 and client_secret is secret_abc:
echo -n "myapp_123:secret_abc" | base64
# bXlhcHBfMTIzOnNlY3JldF9hYmM=Example Request
curl -X POST https://server.prod.querio.ai/v1/embed/{customer_slug}/runs \
-H "Authorization: Basic bXlhcHBfMTIzOnNlY3JldF9hYmM=" \
-H "Content-Type: application/json" \
-d '{
"prompt": "How many shipments happened in the last 30 days",
"dataset_id": "your_dataset_id",
"scope": {
"customer_id": "your_customer_id"
},
"environment": "production"
}'Error Responses
| Status | Code | Description |
|---|---|---|
| 401 | invalid_request | Missing Authorization header or invalid Basic Auth format |
| 401 | invalid_client | Incorrect client_id or client_secret |