List conversations
AuthorizationBearer <token>
Bearer token authentication:
Include your API token in the Authorization header:
Authorization: Bearer <your_token>
You will receive your token during onboarding.
In: header
Path Parameters
customer_slugstring
Your organization's unique identifier
Query Parameters
limit?integer
Maximum number of conversations to return (1–100)
Default
50Range
1 <= value <= 100cursor?string
Pagination cursor from a previous response's nextCursor
search?string
Search term to filter conversations by message text (case-insensitive)
orderBy?string
Field to order results by
Default
"createdAt"Value in
"createdAt" | "updatedAt"orderDirection?string
Sort direction
Default
"desc"Value in
"asc" | "desc"environment?string
Filter by environment
Value in
"production" | "testing"scope.customer_id?string
Filter by customer_id in scope
tag.{key}?string
Filter by tag value. Replace {key} with the tag key name.
Example: tag.user_id=usr_8f3a2b
Response Body
curl -X GET "https://app.querio.ai/api/v2/embed/querio/conversations?limit=50&cursor=string&search=string&orderBy=createdAt&orderDirection=asc&environment=production&scope.customer_id=string&tag.%7Bkey%7D=string"{
"data": [
{
"id": "conv_abc123xyz",
"title": "Shipments in the last 30 days",
"datasourceId": "ds_ship_123",
"scope": {
"customer_id": "550e8400-e29b-41d4-a716-446655440000"
},
"environment": "production",
"tags": {
"user_id": "usr_8f3a2b",
"department": "logistics"
},
"status": "COMPLETED",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:32:00Z"
},
{
"id": "conv_def456uvw",
"title": "Order 123 tracking status",
"datasourceId": "ds_ship_123",
"scope": {
"customer_id": "550e8400-e29b-41d4-a716-446655440000"
},
"environment": "production",
"tags": {
"user_id": "usr_8f3a2b"
},
"status": "RUNNING",
"createdAt": "2026-01-15T11:00:00Z",
"updatedAt": "2026-01-15T11:00:10Z"
}
],
"nextCursor": "conv_def456uvw"
}{
"code": "invalid_client",
"message": "Authentication failed: invalid or expired token"
}{
"code": "querio_error",
"message": "Unexpected internal error"
}