Skip to main content
GET
/
namespaces
/
{namespace_name}
/
file-jobs
/
{job_id}
File Job Status
curl --request GET \
  --url http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}
{
  "job_id": "job-1fad681df00046c0a7f950daeb52f120",
  "job_type": "file_ingest",
  "namespace_name": "my-documents",
  "file_id": "a1b2c3d4e5f67890",
  "absolute_path": "/uploads/document.pdf",
  "status": "completed",
  "chunks_total": 1,
  "chunks_processed": 1,
  "summaries_created": 1,
  "items_deleted": 0,
  "last_error": null,
  "started_at": "2026-06-05T18:53:24Z",
  "updated_at": "2026-06-05T18:53:37Z",
  "finished_at": "2026-06-05T18:53:37Z"
}

​
Overview

Returns status for jobs started by Upload file or Delete file index. The same endpoint handles both job types — check job_type.

​
Path parameters

​
namespace_name
string
required
Namespace the job belongs to.
​
job_id
string
required
Job id from upload or delete response.

​
Request example

curl "http://localhost:8080/namespaces/my-documents/file-jobs/job-1fad681df00046c0a7f950daeb52f120"

​
Response fields

​
job_id
string
Job id.
​
job_type
string
"file_ingest" or "file_delete".
​
namespace_name
string
Target namespace.
​
status
string
running, completed, or failed.
​
file_id
string
File id (set during upload/delete).
​
absolute_path
string
Container path for the file.
​
chunks_total
number
Total chunks expected (ingest) or to delete (delete job).
​
chunks_processed
number
Chunks processed so far (upload).
​
summaries_created
number
Summary chunks created (upload).
​
items_deleted
number
Items removed from the index (delete).
​
last_error
string
Error message when status is failed.
​
started_at
string
ISO 8601 start time.
​
updated_at
string
ISO 8601 last update time.
​
finished_at
string
ISO 8601 end time when completed or failed.
{
  "job_id": "job-1fad681df00046c0a7f950daeb52f120",
  "job_type": "file_ingest",
  "namespace_name": "my-documents",
  "file_id": "a1b2c3d4e5f67890",
  "absolute_path": "/uploads/document.pdf",
  "status": "completed",
  "chunks_total": 1,
  "chunks_processed": 1,
  "summaries_created": 1,
  "items_deleted": 0,
  "last_error": null,
  "started_at": "2026-06-05T18:53:24Z",
  "updated_at": "2026-06-05T18:53:37Z",
  "finished_at": "2026-06-05T18:53:37Z"
}