Get an ingestion job and its counters
Poll an ingestion job’s status, attempt and document counters until is_active turns false. Counters update during the run and are final at its end.
GET
/
knowledge
/
jobs
/
{job_id}
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/knowledge/jobs/9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
job_id = "9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/knowledge/jobs/{job_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const jobId = '9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/knowledge/jobs/${jobId}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"id": "9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40",
"collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
"source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
"status": "partial",
"trigger": "manual",
"source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
"is_active": false,
"attempt": 1,
"max_attempts": 3,
"queued_at": "2026-09-24T10:20:05.127004+00:00",
"started_at": "2026-09-24T10:20:06.340918+00:00",
"finished_at": "2026-09-24T10:22:41.503117+00:00",
"next_attempt_at": null,
"error_code": null,
"error_message": null,
"counters": {
"documents_discovered": 214,
"documents_ingested": 198,
"documents_unchanged": 0,
"documents_skipped": 13,
"documents_failed": 3,
"documents_deleted": 0,
"chunks_written": 1873,
"bytes_fetched": 4718290
}
}
{ "code": "not_found", "message": "The ingestion job was not found." }
Poll this endpoint after syncing a source until
is_active is false. Counters update while the job runs and are final once it ends. See Ingestion for how runs, retries and cancellation work.
Returns 404 both for an ID that does not exist and for a job in another organization. A malformed ID also returns 404. Any role in the organization can read a job.
string
required
Job ID (a UUID).
Response
string
required
Job ID (a UUID).
string
required
Collection being ingested into.
string
required
Source being ingested.
string
required
One of:
pending: created, not yet handed to a worker.queued: waiting for a worker. This is the status a sync returns, and the status a job waits in between retry attempts.running: a worker is ingesting the source.succeeded: the run completed and no document failed. Documents counted indocuments_skippeddo not change this.partial: the run completed and at least one document failed.failed: the run could not proceed, for example because the source was unreachable, the collection is archived, or a hard limit was exceeded. Seeerror_codeanderror_message.cancelled: stopped on request. Documents ingested before the stop remain.skipped: a scheduled re-sync (triggerisscheduled) found the source unchanged since its last successful run, so nothing was re-read. A run Sync a source starts always re-reads the source and never endsskipped, and neither does a scheduled run of a website or sitemap source.
is_active to decide whether to keep polling.string
required
What started the run:
manual, scheduled or api. Jobs started by Sync a source are manual.string | null
required
The source version the run read, such as a commit SHA for a GitHub source.
null until the run starts.boolean
required
true while the status is pending, queued or running.integer
required
Which attempt this is, starting at
1.integer
required
Total attempts allowed. Only whole-run failures with a transient cause are retried.
string | null
required
ISO 8601 timestamp, in UTC, when the current attempt was queued.
string | null
required
ISO 8601 timestamp, in UTC, when the current attempt started.
null before then.string | null
required
ISO 8601 timestamp, in UTC, when the job ended.
null while it is active.string | null
required
ISO 8601 timestamp, in UTC, before which a queued retry will not start.
null when no retry is waiting.string | null
required
Stable error code when the run failed, such as
validation_error or dependency_failure. Otherwise null.string | null
required
Readable description of the failure. Otherwise
null.object
required
What happened to the source’s documents in this run.
Show properties
Show properties
integer
required
Documents the run has taken from the source so far. Each one is then counted as ingested, unchanged, skipped or failed. A file the source refuses while listing, such as an unsupported type or an excluded path, is counted only in
documents_skipped.integer
required
Documents written or updated.
integer
required
Documents whose content had not changed.
integer
required
Documents not ingested and not counted as failed: an unsupported file type, an unsafe path, a file over a size limit, a path your configuration excludes, a document with no indexable text, an uploaded file missing from storage, or a web page that could not be fetched or did not answer
200.integer
required
Documents that could not be ingested.
integer
required
Documents removed because they are no longer in the source.
integer
required
Indexed passages written.
integer
required
Bytes read from the source.
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/knowledge/jobs/9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
job_id = "9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/knowledge/jobs/{job_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const jobId = '9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/knowledge/jobs/${jobId}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"id": "9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40",
"collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
"source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
"status": "partial",
"trigger": "manual",
"source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
"is_active": false,
"attempt": 1,
"max_attempts": 3,
"queued_at": "2026-09-24T10:20:05.127004+00:00",
"started_at": "2026-09-24T10:20:06.340918+00:00",
"finished_at": "2026-09-24T10:22:41.503117+00:00",
"next_attempt_at": null,
"error_code": null,
"error_message": null,
"counters": {
"documents_discovered": 214,
"documents_ingested": 198,
"documents_unchanged": 0,
"documents_skipped": 13,
"documents_failed": 3,
"documents_deleted": 0,
"chunks_written": 1873,
"bytes_fetched": 4718290
}
}
{ "code": "not_found", "message": "The ingestion job was not found." }
Last modified on November 7, 2026
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/knowledge/jobs/9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
job_id = "9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/knowledge/jobs/{job_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const jobId = '9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/knowledge/jobs/${jobId}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"id": "9a4c2e71-6b0d-4f38-a5e2-1c7d8f3b6e40",
"collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
"source_id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
"status": "partial",
"trigger": "manual",
"source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
"is_active": false,
"attempt": 1,
"max_attempts": 3,
"queued_at": "2026-09-24T10:20:05.127004+00:00",
"started_at": "2026-09-24T10:20:06.340918+00:00",
"finished_at": "2026-09-24T10:22:41.503117+00:00",
"next_attempt_at": null,
"error_code": null,
"error_message": null,
"counters": {
"documents_discovered": 214,
"documents_ingested": 198,
"documents_unchanged": 0,
"documents_skipped": 13,
"documents_failed": 3,
"documents_deleted": 0,
"chunks_written": 1873,
"bytes_fetched": 4718290
}
}
{ "code": "not_found", "message": "The ingestion job was not found." }