Namespaces

Ein Namespace ist eine benannte Menge von Dokumenten; der erste Schreibvorgang legt ihn an, und ein Namespace pro Nutzer hält die Daten der Nutzer getrennt.

Namespaces auflisten

GET /namespaces

curl "https://api.conare.ai/namespaces?prefix=user-" \
  -H "Authorization: Bearer $CONARE_API_KEY"

await conare.namespaces({ prefix: "user-" });

Response

{
  "namespaces": [
    {
      "name": "user-42",
      "documents": 2,
      "embedding_model": "conare-embed-1",
      "rerank_model": "conare-rerank-1",
      "created_at": "2026-10-21T21:38:52.859567Z",
      "updated_at": "2026-10-21T21:38:52.895Z",
      "last_query_at": "2026-10-21T21:38:54.56266Z"
    }
  ]
}

Option	Typ	Funktion
`prefix`	string	Nur Namespaces, deren Namen damit beginnen

Feld	Bedeutung
`name`, `documents`	Der Namespace und wie viele Dokumente er enthält
`embedding_model`, `rerank_model`	Die Modelle, die er verwendet
`created_at`	Wann er angelegt wurde; vor dem 18.10.2026, wann sein ältestes Dokument geschrieben wurde (`null`, wenn er keines enthält)
`updated_at`	Sein letzter Schreibvorgang
`last_query_at`	Seine letzte Suche, höchstens einmal pro Minute erfasst; `null`, wenn seit dem 18.10.2026 nicht durchsucht

Vollständiges Schema: Namespaces auflisten.

Einen Namespace abrufen

GET /namespaces/:namespace Gibt einen Namespace mit denselben Feldern zurück, oder 404 namespace_not_found.

curl

curl https://api.conare.ai/namespaces/user-42 \
  -H "Authorization: Bearer $CONARE_API_KEY"

Vollständiges Schema: Einen Namespace abrufen.

Einen Namespace anlegen

POST /namespaces Nur für ein Modell nötig, das für Ihre Organisation trainiert wurde: Legen Sie den Namespace vor seinem ersten Schreibvorgang an.

curl

curl https://api.conare.ai/namespaces \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "contracts", "embedding_model": "<your model id>"}'

Option	Typ	Funktion
`name`	string, erforderlich	1-64 Zeichen aus `a-z 0-9 _ -`, beginnend mit einem Buchstaben oder einer Ziffer
`embedding_model`	string	Die Id Ihres Modells; Standard ist `conare-embed-1`

Gibt name, embedding_model und rerank_model zurück; das erneute Anlegen eines bestehenden Namespace liefert dasselbe. Vollständiges Schema: Einen Namespace anlegen.

Einen Namespace löschen

DELETE /namespaces/:namespace Löscht den Namespace, alle seine Dokumente und seine hochgeladenen Dateien; dies kann nicht rückgängig gemacht werden.

curl -X DELETE https://api.conare.ai/namespaces/docs \
  -H "Authorization: Bearer $CONARE_API_KEY"

await conare.namespace("docs").drop();

Response

{ "deleted": true, "sources_deleted": ["src_01139ca8ca59f2556f65b60e"] }

Option	Typ	Funktion
`force`	boolean, Standard `false`	Auch die Quellen löschen, die in ihn schreiben

Ohne force gibt ein Namespace, in den eine verbundene App oder ein Bucket schreibt, 409 namespace_has_sources zurück, mit deren Ids in details.source_ids.
sources_deleted listet die mitgelöschten Quellen auf; GET /sources/:id zeigt deleted, sobald jede fertig ist.

Vollständiges Schema: Einen Namespace löschen.

Erste Schritte

Grundlagen

Dateien

Synchronisierung

Modelle

Tools

Namespaces auflisten

Einen Namespace abrufen

Einen Namespace anlegen

Einen Namespace löschen

​Namespaces auflisten

​Einen Namespace abrufen

​Einen Namespace anlegen

​Einen Namespace löschen

Namespaces auflisten

Einen Namespace abrufen

Einen Namespace anlegen

Einen Namespace löschen