CvdsRun

State of a single search run, as returned by GET /api/v1/cvds/runs/{id}. The results fields are pending the results pipeline — until it ships, results is null and results_pending is true.

idstringrequired

The run id (opaque cvds_… string).

Example: cvds_8mK2pQ7rT1aB9xY3wZ0vNn

statusstringrequired

The run lifecycle state. pending while the search is in progress; terminal states (the completed / failed values) are finalized with the results pipeline.

Example: pending

corpus_idstring

Example: acme-eng-pool

position_idstringnullable

Example: eng-backend-2026

job_idstringnullable

The saved job this run resolved to (run→job attribution). null for pure inline runs and runs predating the Jobs catalog.

is_job_updatedbooleannullable

The effective plan-rebuild flag the run executed with — the client-sent value for inline runs, the platform-derived value for saved-job runs.

top_nintegernullable

Example: 50

sourcestring

Traffic origin — requests for API-key calls, playground for console calls.

Possible values: [requests, playground]

created_atdate-time

resultsnullable

Pending the results pipeline. Always null for now; the best-first candidate list lands with the GET /api/v1/cvds/runs/{id}/results endpoint in a follow-up release.

results_pendingboolean

true while the results side is not yet finalized. Will be removed once results land.

CvdsRun

{
  "id": "cvds_8mK2pQ7rT1aB9xY3wZ0vNn",
  "status": "pending",
  "corpus_id": "acme-eng-pool",
  "position_id": "eng-backend-2026",
  "job_id": "string",
  "is_job_updated": true,
  "top_n": 50,
  "source": "requests",
  "created_at": "2024-07-29T15:51:28.071Z",
  "results_pending": true
}