Embed QuerioEmbedded API
List conversations
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.
Query Parameters
limit?integer
Results per page.
Default
20Range
1 <= value <= 100cursor?string
Pagination cursor from the previous response.
search?string
Free-text search across conversations.
orderBy?string
Sort field.
Default
"createdAt"Value in
"createdAt" | "updatedAt"orderDirection?string
Sort direction.
Default
"desc"Value in
"asc" | "desc"environment?string
Filter by environment.
scope.customer_id?string
Filter by scope customer ID.
tag.{key}?string
Filter by tag key-value pair. Repeatable with different keys.
Response Body
curl -X GET "https://app.querio.ai/api/v2/embed/dunder-mifflin/conversations?limit=20&cursor=string&search=string&orderBy=createdAt&orderDirection=asc&environment=string&scope.customer_id=string&tag.%7Bkey%7D=string"{
"data": [
{
"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"
}
],
"nextCursor": "eyJpZCI6Ii4uLiJ9"
}{
"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"
}