moorcheh upload-documents

Overview

Uploads documents from a JSON file to a text namespace. Embeddings are computed via Ollama. Returns an async job_id — poll with moorcheh upload-job-status.

Synopsis

moorcheh upload-documents --namespace-name NAME --documents-file PATH [--base-url URL]

Options

Flag	Required	Description
`--namespace-name`	Yes	Target text namespace
`--documents-file`	Yes	Path to JSON file with a `documents` array
`--base-url`	No	Default `http://localhost:8080`

Documents file format

docs.json:

{
  "documents": [
    {
      "id": "doc-1",
      "text": "Moorcheh on-prem retrieval test",
      "team": "ai"
    }
  ]
}

Extra keys on each document (for example team) are stored as metadata.

Examples

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

moorcheh upload-job-status --namespace-name my-documents --job-id <job_id>

Output

Prints JSON from POST /namespaces/{namespace_name}/documents:

string

"success" when the upload job was started; "failure" on error.

string

Human-readable result or error description.

string

Async upload job id.

string

Target namespace.

number

Number of documents accepted into the job.

number

Current item count. Present on 409 item limit errors.

number

Global item cap. Present on 409 errors.

number

New ids that would exceed the cap. Present on 409 errors.

Example output

{
  "status": "success",
  "message": "Documents upload started. Poll job status for progress.",
  "job_id": "job-9889a2ea08034064adb584d0afdf45b1",
  "namespace_name": "my-documents",
  "total": 1
}

Exit codes

Code	Meaning
`0`	Upload job started
`1`	API error (400, 404, 409, etc.) — error JSON on stdout, message on stderr

Getting Started

Runtime

Namespace Management

Search

AI Generation

Data Operations

File storage

Items

Overview

Synopsis

Options

Documents file format

Examples

Output

Exit codes

​Overview

​Synopsis

​Options

​Documents file format

​Examples

​Output

​Exit codes

​Related

Overview

Synopsis

Options

Documents file format

Examples

Output

Exit codes

Related