Skip to content
Peritus
API reference · Changes

Get job

GET/v1/jobs/{job_id}

One of your indexing jobs, which a search that names days a source has not indexed queues: its status, its estimated end, and when done the fact versions it wrote. With Accept text/event-stream it streams the job as it changes and an upgrade event with the new fact version IDs when it finishes.

scope
read
auth
Bearer key
operationId
GetJob
MCP tool
get_job

Parameters

Parameters
FieldInTypeRequiredLimits
job_idpathJobIDyes

Response

200 · JobResponse. The job, or with Accept text/event-stream its events.

Response fields
FieldTypeHolds
jobobjectAn on-demand indexing job of the days from up to to of one source's scope. files and missing are the files it read and the files the publisher does not serve; fact_version_ids are the versions it wrote, set when done; error is set when failed.

Problems

RFC 9457 application/problem+json. An abstention is not one of these: it is a 200.

Problems
HTTPCodeWhen
400INVALID_REQUESTMalformed JSON, unknown fields, bad filter, limit exceeded
401UNAUTHENTICATEDMissing, malformed, or revoked key
403FORBIDDEN_SCOPEThe key lacks the required scope
404NOT_FOUNDUnknown response, job, document, or reserved route
429RATE_LIMITEDRate limit or per-tenant model cap
500INTERNAL, POLICY_ASSERT_FAILED, RESPONSE_UNREPLAYABLEServer fault. The last two also alert
503STORE_UNAVAILABLE, LLM_UNAVAILABLE, LOG_UNAVAILABLEA dependency is down or a budget tripped
504TIMEOUTA deadline was exceeded