Query a Collection
Query a Collection of Inputs
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the Collection to query. All Inputs in the Collection must be uploaded and in a valid state for queries. Queries on a video Collection are disabled until each video in the Collection has completed it's background analysis pre-processing .
Body
The question to ask about the input content. Required if use_preset is false.
10000The type of the query. Synchronous queries block and return results in response. For video input collections, queries must use artifacts from the auto-triggered analyze inference job.
synchronous, asynchronous Private preview: Use custom context for synchronous queries. If set to true, the response populates structured_answer. Reach out to [email protected] to setup custom context and structured responses.
Response
Query processed successfully
asynchronous, synchronous, background The perception model used for this query.
perception-0-fast, perception-0-thinking The status of the query. Synchronous queries always return completed status.
processing, completed, failed Whether structured output was requested for this query.
"What's happening in this video?"
Natural language answer. Populated when use_preset is false.
URI to full answer when result is too long.
Structured JSON response when use_preset is true. Reach out to [email protected] to configure structured responses.
User feedback
"2026-04-20T12:34:56.000Z"