Querio

List all runs

GET
/v1/embed/{customer_slug}/runs
AuthorizationBasic <token>

Basic Authentication using client credentials:

  • Username: client_id (provided during onboarding)
  • Password: client_secret (shared once, never expires)

Format: Authorization: Basic <base64(client_id:client_secret)>

Example: If your client_id is "myapp_123" and client_secret is "secret_abc", encode "myapp_123:secret_abc" in base64.

In: header

Path Parameters

customer_slugstring

Your organization's unique identifier

Query Parameters

workspace_idstring

Workspace identifier

search?string

Search term to filter runs by question (case-insensitive)

orderBy?string

Field to order results by

Default"createdAt"
Value in"question" | "status" | "datasourceId" | "createdAt"
orderDirection?string

Sort direction

Default"desc"
Value in"asc" | "desc"
environment?string

Filter by environment

Value in"production" | "testing"
limit?integer

Maximum number of runs to return (1-100)

Default50
Range1 <= value <= 100
cursor?string

Pagination cursor from previous response

scope.customer_id?string

Filter by customer_id in scope

Response Body

curl -X GET "https://server.prod.querio.ai/v1/embed/querio/runs?workspace_id=string&search=string&orderBy=question&orderDirection=asc&environment=production&limit=50&cursor=string&scope.customer_id=string"

{
  "data": [
    {
      "id": "cku9m0u1p0001abcxyz",
      "question": "How many shipments happened in the last 30 days",
      "datasourceId": "ds_ship_123",
      "scope": {
        "customer_id": "550e8400-e29b-41d4-a716-446655440000"
      },
      "environment": "production",
      "createdAt": "2023-01-01T00:00:00Z",
      "updatedAt": "2023-01-01T00:00:00Z",
      "status": "success"
    },
    {
      "id": "cku9m0u1p0002abcxyz",
      "question": "What is the status of order 123",
      "datasourceId": "ds_ship_123",
      "scope": {
        "customer_id": "550e8400-e29b-41d4-a716-446655440000"
      },
      "environment": "production",
      "createdAt": "2023-01-01T01:00:00Z",
      "updatedAt": "2023-01-01T01:00:00Z",
      "status": "processing"
    }
  ],
  "nextCursor": "cku9m0u1p0002abcxyz"
}

{
  "code": "invalid_client",
  "message": "Client authentication failed: bad client_id or client_secret"
}

{
  "code": "querio_error",
  "message": "Unexpected internal error"
}