moorcheh upload-job-status

Overview

Polls an async upload started by moorcheh upload-documents or moorcheh upload-vectors. Prints job progress as JSON. Repeat until status is completed. Check successful and failed for per-item results.

Synopsis

moorcheh upload-job-status --namespace-name NAME --job-id JOB_ID [--base-url URL]

Options

Flag	Required	Description
`--namespace-name`	Yes	Namespace the job belongs to
`--job-id`	Yes	Job id from upload command output
`--base-url`	No	Default `http://localhost:8080`

Examples

moorcheh upload-documents --namespace-name my-documents --documents-file docs.json

moorcheh upload-job-status \
  --namespace-name my-documents \
  --job-id job-9889a2ea08034064adb584d0afdf45b1

Output

Prints JSON from GET /namespaces/{namespace_name}/upload-jobs/{job_id}:

string

Upload job id.

string

Namespace being uploaded to.

string

"running" or "completed". On lookup errors: "failure".

number

Total items in the upload batch.

number

Items processed so far.

number

Items successfully persisted.

number

Items that failed during processing.

string | null

Most recent per-item error; null if none.

string

Job start time (ISO 8601 UTC).

string

Last update time (ISO 8601 UTC).

string | null

Job finish time; null while running.

string

Error description when the job cannot be found.

Example output (completed)

{
  "job_id": "job-9889a2ea08034064adb584d0afdf45b1",
  "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:03.000Z",
  "finished_at": "2026-05-21T12:00:03.000Z"
}

Exit codes

Code	Meaning
`0`	Job status returned
`1`	API error (404, etc.)

Getting Started

Runtime

Namespace Management

Search

AI Generation

Data Operations

File storage

Items

Overview

Synopsis

Options

Examples

Output

Exit codes

​Overview

​Synopsis

​Options

​Examples

​Output

​Exit codes

​Related

Overview

Synopsis

Options

Examples

Output

Exit codes

Related