Embed QuerioEmbedded API
Get a conversation
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_slugstring
Customer slug that maps to a workspace and agent configuration.
conversationIdstring
Conversation identifier.
Format
uuidResponse Body
curl -X GET "https://app.querio.ai/api/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"
}