Upload Job Status

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
}

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

{
  "job_id": "job-a0e3d54b9d0d4616949474697308a39c",
  "namespace_name": "my-documents",
  "status": "completed",
  "total": 10,
  "processed": 10,
  "successful": 9,
  "failed": 1,
  "last_error": "text is required for text namespace upload",
  "started_at": "2026-05-21T12:00:00.000Z",
  "updated_at": "2026-05-21T12:00:05.000Z",
  "finished_at": "2026-05-21T12:00:05.000Z"
}

{
  "status": "failure",
  "message": "Job not found."
}

{
  "status": "failure",
  "message": "Job not found for namespace."
}

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
}

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

{
  "job_id": "job-a0e3d54b9d0d4616949474697308a39c",
  "namespace_name": "my-documents",
  "status": "completed",
  "total": 10,
  "processed": 10,
  "successful": 9,
  "failed": 1,
  "last_error": "text is required for text namespace upload",
  "started_at": "2026-05-21T12:00:00.000Z",
  "updated_at": "2026-05-21T12:00:05.000Z",
  "finished_at": "2026-05-21T12:00:05.000Z"
}

{
  "status": "failure",
  "message": "Job not found."
}

{
  "status": "failure",
  "message": "Job not found for namespace."
}

Overview

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

Path parameters

string

required

Namespace the upload job belongs to. Must match the namespace used when the job was started.

string

required

Job id returned from the upload response.

curl "http://localhost:8080/namespaces/my-documents/upload-jobs/job-a0e3d54b9d0d4616949474697308a39c"

Response fields

string

Id of the upload job.

string

Namespace items are being uploaded to.

string

Job state on success: "running" or "completed". On lookup errors: "failure".

number

Total number of documents or vectors in the upload batch.

number

Number of items processed so far (embedded or validated).

number

Number of items successfully persisted.

number

Number of items that failed during processing. Check last_error for the most recent failure reason.

string | null

Most recent per-item error message during processing; null if none.

string

ISO 8601 UTC timestamp when the job started.

string

ISO 8601 UTC timestamp of the last job update.

string | null

ISO 8601 UTC timestamp when the job finished; null while status is "running".

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
}

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

{
  "job_id": "job-a0e3d54b9d0d4616949474697308a39c",
  "namespace_name": "my-documents",
  "status": "completed",
  "total": 10,
  "processed": 10,
  "successful": 9,
  "failed": 1,
  "last_error": "text is required for text namespace upload",
  "started_at": "2026-05-21T12:00:00.000Z",
  "updated_at": "2026-05-21T12:00:05.000Z",
  "finished_at": "2026-05-21T12:00:05.000Z"
}

{
  "status": "failure",
  "message": "Job not found."
}

{
  "status": "failure",
  "message": "Job not found for namespace."
}

System

Namespace Management

Search

AI Generation

Data Operations

File storage

Items

Overview

Path parameters

Response fields

​Overview

​Path parameters

​Response fields

​Related

Overview

Path parameters

Response fields

Related