Dokumente abrufen, auflisten und löschen

Um alles in einem Namespace zu löschen, löschen Sie den Namespace.

Ein Dokument abrufen

GET /namespaces/:namespace/documents/:id Gibt ein Dokument mit vollständigem Text zurück, oder 404 document_not_found.

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

const doc = await docs.get("refunds"); // null if it doesn't exist

Response

{
  "id": "refunds",
  "text": "Refunds are available for 30 days.",
  "metadata": { "team": "support" },
  "updated_at": "2026-10-21T21:38:52Z",
  "version": 1
}

Feld	Bedeutung
`id`, `text`, `metadata`	Das Dokument
`updated_at`	Wann es sich zuletzt geändert hat, in UTC
`version`	Steigt mit jeder Änderung
`user`, `seq`	Wie geschrieben, sofern gesetzt

Vollständiges Schema: Ein Dokument abrufen.

Dokumente auflisten

GET /namespaces/:namespace/documents Gibt Dokumente in Id-Reihenfolge zurück, ohne ihren Text.

curl "https://api.conare.ai/namespaces/docs/documents?limit=100" \
  -H "Authorization: Bearer $CONARE_API_KEY"

for await (const doc of docs.list()) {
  console.log(doc.id, doc.version); // reads every page
}

Response

{
  "documents": [
    { "id": "refunds", "metadata": { "team": "support" }, "updated_at": "2026-10-21T21:38:52Z", "version": 1 },
    { "id": "shipping", "metadata": { "team": "ops" }, "updated_at": "2026-10-21T21:38:52Z", "version": 1 }
  ],
  "next_cursor": null
}

Option	Typ	Funktion
`limit`	integer, Standard 50	Dokumente pro Seite, 1-100
`cursor`	string	Der `next_cursor` der vorherigen Seite, der auf der letzten Seite `null` ist

Vollständiges Schema: Dokumente auflisten.

Ein Dokument löschen

DELETE /namespaces/:namespace/documents/:id Löscht ein Dokument oder gibt 404 document_not_found zurück.

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

await docs.delete("refunds");

Response

{ "deleted": true }

Vollständiges Schema: Ein Dokument löschen.

Mehrere löschen

POST /namespaces/:namespace/documents/delete Löscht eine Liste von Ids oder jedes Dokument, auf das ein Filter passt: Senden Sie ids oder filter, nicht beides.

curl https://api.conare.ai/namespaces/docs/documents/delete \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["refunds", "shipping"]}'

curl https://api.conare.ai/namespaces/docs/documents/delete \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter": {"team": "support"}}'

await docs.deleteMany(["refunds", "shipping"]); // how many were deleted
await docs.deleteWhere({ team: "support" });    // repeats until done

Response

{ "deleted": 2, "more": false }

Option	Typ	Funktion
`ids`	array	1-1.000 Dokument-Ids; fehlende Ids werden übersprungen
`filter`	object	Ein Filter, ohne `$ne` oder `$nin`

deleted gibt an, wie viele dieser Aufruf gelöscht hat.
Ein Filter löscht in Stapeln: Solange more true ist, senden Sie ihn erneut.

Ein falsch geschriebener Filterschlüssel passt auf nichts, also wird nichts gelöscht.

Vollständiges Schema: Dokumente nach Id oder Filter löschen.

Erste Schritte

Grundlagen

Dateien

Synchronisierung

Modelle

Tools

Dokumente abrufen, auflisten und löschen

Ein Dokument abrufen

Dokumente auflisten

Ein Dokument löschen

Mehrere löschen

​Ein Dokument abrufen

​Dokumente auflisten

​Ein Dokument löschen

​Mehrere löschen

Ein Dokument abrufen

Dokumente auflisten

Ein Dokument löschen

Mehrere löschen