Embed QuerioEmbedded API
Get 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.
conversationId*string
Conversation identifier.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/embed/dunder-mifflin/conversations/38770bb6-b14b-405c-aed6-71e8849c77dc"{ "id": "38770bb6-b14b-405c-aed6-71e8849c77dc", "title": "Recent orders analysis", "datasourceId": "cls_abc123", "scope": { "customer_id": "acme-corp" }, "environment": "production", "tags": { "team": "sales" }, "status": "COMPLETED", "createdAt": "2026-04-08T12:00:00.000Z", "updatedAt": "2026-04-08T12:01:30.000Z", "messages": [ { "id": "msg-0", "role": "user", "createdAt": "2026-04-08T12:00:00.000Z", "parts": [ { "type": "text", "text": "Show me the last 10 orders" } ] }, { "id": "msg-1", "role": "assistant", "createdAt": "2026-04-08T12:01:30.000Z", "parts": [ { "type": "text", "text": "Here are your 10 most recent orders." }, { "type": "data-table", "id": "asset-orders-sample", "data": { "title": "Recent Orders", "url": "/api/v2/embed/dunder-mifflin/conversations/38770bb6-b14b-405c-aed6-71e8849c77dc/assets/orders-sample" } }, { "type": "data-chart", "id": "asset-orders-viz", "data": { "title": "Orders by Revenue", "url": "/api/v2/embed/dunder-mifflin/conversations/38770bb6-b14b-405c-aed6-71e8849c77dc/assets/orders-viz" } } ], "toolOutputs": [ { "name": "run_sql_cell", "callId": "toolu_01abc...", "result": "..." } ] } ]}{ "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": "not_found", "message": "Conversation or asset not found"}Last updated on July 13, 2026