Embed QuerioEmbedded API
List conversations
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.
Query Parameters
limit?integer
Results per page.
Range
1 <= value <= 100Default
20cursor?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
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/embed/dunder-mifflin/conversations"{ "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"}Last updated on July 13, 2026