Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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

FlagRequiredDescription
--namespace-nameYesNamespace the job belongs to
--job-idYesJob id from upload command output
--base-urlNoDefault 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}:
​
job_id
string
Upload job id.
​
namespace_name
string
Namespace being uploaded to.
​
status
string
"running" or "completed". On lookup errors: "failure".
​
total
number
Total items in the upload batch.
​
processed
number
Items processed so far.
​
successful
number
Items successfully persisted.
​
failed
number
Items that failed during processing.
​
last_error
string | null
Most recent per-item error; null if none.
​
started_at
string
Job start time (ISO 8601 UTC).
​
updated_at
string
Last update time (ISO 8601 UTC).
​
finished_at
string | null
Job finish time; null while running.
​
message
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

CodeMeaning
0Job status returned
1API error (404, etc.)