Get a single topic-extraction run
Returns the status and progress counters of one topic-extraction run. Use processed / totalSources for a progress bar.
Headers
Project ID to specify the project context
Path Parameters
UUID of the run to retrieve.
Response
Run UUID.
"019dd32e-b19e-7956-88f6-4b9a877f3697"
Lifecycle status of the run.
pending, running, completed, failed "running"
Total sources (jobs) enqueued for this run.
100
Sources processed so far (vectorized + skippedNoMeta + skippedPreMeta + failed). Use processed / totalSources for a progress bar.
64
Sources whose metadata was embedded + stored.
41
Sources skipped because no metadata sidecar was cached.
18
Sources skipped because the snapshot predates metadata caching.
4
Sources whose job failed terminally (retries exhausted).
1
Snapshot of the filters that produced this run.
When the run was created.
"2026-06-25T13:35:29.000Z"
When the run last changed.
"2026-06-25T13:38:02.000Z"
When the run finished (null while still running).
"2026-06-25T13:40:11.000Z"
Topic-clustering lifecycle, independent of embedding status. pending while embedding; clustering once the topic job runs; ready when topics are available; failed on clustering error. Poll until ready, then GET /source-topics/runs/{runId}/topics.
pending, clustering, ready, failed "ready"
When topic clustering finished (null until ready/failed).
"2026-06-25T13:41:02.000Z"