moorcheh upload-vectors

Overview

Uploads precomputed vectors from a JSON file to a vector namespace. Returns an async job_id — poll with moorcheh upload-job-status. Each vector length must match the namespace vector_dimension.

Synopsis

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

Options

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

Vectors file format

vectors.json:

{
  "vectors": [
    {
      "id": "vec-1",
      "vector": [0.1, 0.2, 0.3, 0.4, 0.5],
      "source": "demo"
    }
  ]
}

The vector array length must match vector_dimension for the namespace (for example 5 or 768).

Examples

moorcheh upload-vectors --namespace-name my-embeddings --vectors-file vectors.json

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

Output

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

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 vectors 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": "Vectors upload started. Poll job status for progress.",
  "job_id": "job-86a80193802144bbb718b48b1954997d",
  "namespace_name": "my-embeddings",
  "total": 1
}

Exit codes

Code	Meaning
`0`	Upload job started
`1`	API error (400, 404, 409, etc.)

Getting Started

Runtime

Namespace Management

Search

AI Generation

Data Operations

File storage

Items

Overview

Synopsis

Options

Vectors file format

Examples

Output

Exit codes

​Overview

​Synopsis

​Options

​Vectors file format

​Examples

​Output

​Exit codes

​Related

Overview

Synopsis

Options

Vectors file format

Examples

Output

Exit codes

Related