Preview a structured query against canonical parquet for one dataset version.

Authorization

Send a personal access token with every request.

• Authorization: Bearer PAT

Header parameters

• Idempotency-Keystring

  Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

Request body

• datasetVersionIdstring (uuid)required
• expectedQueryIndexSha256string
• granularitystring
  Allowed values

  episode

  frame
• episodeIndexInarray<number>
• episodeIdInarray<string>
• frameIndexMinnumber
• frameIndexMaxnumber
• timestampNsMinstring
• timestampNsMaxstring
• featurePredicatesarray<DatasetVersionQueryPredicateBodyDto>
  Hide child attributes
  • pathstringrequired
  • opstringrequired
    Allowed values

    in

    lt

    lte

    gt

    gte

    eq

    neq
  • valueobjectrequired
• metadataEqualsobject
• cameraNameInarray<string>
• fieldsarray<string>
• limitnumber
• offsetnumber
• orderBystring
  Allowed values

  episodeIndex

  timestampNs

  frameIndex
• orderDirectionstring
  Allowed values

  asc

  desc
• aggregateobject
  Hide child attributes
  • fnstringrequired
    Allowed values

    count
  • fieldstring

Responses

{
  "data": {
    "datasetVersionId": "string",
    "queryIndexSha256": "string",
    "granularity": "frame",
    "episodeStatisticsGranularity": "coarse",
    "rows": [
      {}
    ],
    "totalEstimate": 0,
    "truncated": false,
    "videoRefs": [
      {
        "episodeIndex": 0,
        "cameraName": "string",
        "storageObjectId": "string",
        "logicalPath": "string"
      }
    ],
    "elapsedMs": 0,
    "excludedCount": 0
  }
}