Skip to main content
GET
/
namespaces
/
{namespace_name}
/
upload-jobs
/
{job_id}
curl "http://localhost:8080/namespaces/my-documents/upload-jobs/job-a0e3d54b9d0d4616949474697308a39c"

{
  "job_id": "job-a0e3d54b9d0d4616949474697308a39c",
  "namespace_name": "my-documents",
  "status": "running",
  "total": 1,
  "processed": 0,
  "successful": 0,
  "failed": 0,
  "last_error": null,
  "started_at": "2026-05-21T12:00:00.000Z",
  "updated_at": "2026-05-21T12:00:00.000Z",
  "finished_at": null
}

​
Overview

Returns status for an upload started by Upload documents or Upload vectors.

​
Path parameters

​
namespace_name
string
required
Namespace the upload job belongs to. Must match the namespace used when the job was started.
​
job_id
string
required
Job id returned from the upload response.
curl "http://localhost:8080/namespaces/my-documents/upload-jobs/job-a0e3d54b9d0d4616949474697308a39c"

​
Response fields

​
job_id
string
Id of the upload job.
​
namespace_name
string
Namespace items are being uploaded to.
​
status
string
Job state on success: "running" or "completed". On lookup errors: "failure".
​
total
number
Total number of documents or vectors in the upload batch.
​
processed
number
Number of items processed so far (embedded or validated).
​
successful
number
Number of items successfully persisted.
​
failed
number
Number of items that failed during processing. Check last_error for the most recent failure reason.
​
last_error
string | null
Most recent per-item error message during processing; null if none.
​
started_at
string
ISO 8601 UTC timestamp when the job started.
​
updated_at
string
ISO 8601 UTC timestamp of the last job update.
​
finished_at
string | null
ISO 8601 UTC timestamp when the job finished; null while status is "running".
​
message
string
Error description when the job cannot be found.
{
  "job_id": "job-a0e3d54b9d0d4616949474697308a39c",
  "namespace_name": "my-documents",
  "status": "running",
  "total": 1,
  "processed": 0,
  "successful": 0,
  "failed": 0,
  "last_error": null,
  "started_at": "2026-05-21T12:00:00.000Z",
  "updated_at": "2026-05-21T12:00:00.000Z",
  "finished_at": null
}