Poll a search run

GET 
/api/v1/cvds/runs/:id

Return the current state of a search run. Cross-tenant requests return 404 to avoid leaking the existence of other clients' run ids.

Results pending. The best-first candidate results, and the companion GET /api/v1/cvds/runs/{id}/results pagination endpoint, are finalized in a follow-up release. Until then this endpoint returns the run's status and echoed inputs with results: null and results_pending: true.

Request

Responses

200

Current run state. Results are pending (see the note above).

401

Missing or invalid API key.

403

Authenticated but missing the cvdeepsearch permission.

404

No run with this id for the authenticated client. Returned for cross-tenant requests to avoid leaking other clients' ids.