Zum Hauptinhalt springen
POST

Autorisierungen

Authorization
string
header
erforderlich

A key from conare.ai/dashboard/keys with full access, some namespaces, or models only (/embed, /rerank, /v1, /v2/rerank, /parse).

Header

Idempotency-Key
string

One key (a UUID) per logical write, sent again on each retry: a repeat within 24 hours replays the first successful answer.

Required string length: 1 - 255
Pattern: ^[\x21-\x7e]+$

Pfadparameter

namespace
string
erforderlich

The namespace name. 1-64 characters of a-z 0-9 _ -, starting with a letter or digit.

Pattern: ^[a-z0-9][a-z0-9_-]{0,63}$
Beispiele:

"docs"

"user-42"

Body

application/json
ids
string[]
Required array length: 1 - 1000 elements

1-256 characters of A-Z a-z 0-9 . _ : -, starting with a letter or digit.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$
filter
object

{"key": value} matches equal values (or arrays holding it); $eq, $ne, $in, $nin, $gt, $gte, $lt and $lte compare, $and and $or combine.

  • A filter holds at most 256 conditions (each value, $in item, range and join counts one), else 400 invalid_filter.
  • Ranges compare numbers with numbers and strings by UTF-8 bytes: write dates alike (2025-06-01) to sort them.
  • $ne and $nin work in queries, not deletes, and match documents without the key.
Beispiele:

Antwort

How many documents this call deleted, and whether more match the filter.

deleted
integer
erforderlich
more
boolean
erforderlich

Only a filter call answers true.