Embed QuerioEmbedded API
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.
Response Body
application/json
application/json
application/json
application/json
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", "datasourceId": "cls_abc123", "model": "claude-sonnet-5", "scope": { "customer_id": "acme-corp" }, "environment": "production", "tags": { "team": "sales", "source": "app" } }'{ "id": "38770bb6-b14b-405c-aed6-71e8849c77dc", "title": "Recent orders analysis", "datasourceId": "cls_abc123", "status": "PENDING", "createdAt": "2026-04-08T12:00:00.000Z", "updatedAt": "2026-04-08T12:00:00.000Z", "messages": [ { "id": "msg-0", "role": "user", "createdAt": "2026-04-08T12:00:00.000Z", "parts": [ { "type": "text", "text": "Show me the last 10 orders" } ] } ]}{ "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"}Last updated on July 13, 2026