Obtenir, lister et supprimer des documents

Pour tout supprimer dans un namespace, supprimez le namespace.

Obtenir un document

GET /namespaces/:namespace/documents/:id Renvoie un document avec son texte complet, ou 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
}

Champ	Signification
`id`, `text`, `metadata`	Le document
`updated_at`	Sa dernière modification, en UTC
`version`	Augmente à chaque modification
`user`, `seq`	Tels qu’écrits, s’ils sont définis

Schéma complet : Obtenir un document.

Lister les documents

GET /namespaces/:namespace/documents Renvoie les documents par ordre d’id, sans leur texte.

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	Type	Rôle
`limit`	integer, 50 par défaut	Documents par page, 1-100
`cursor`	string	Le `next_cursor` de la page précédente, qui vaut `null` sur la dernière page

Schéma complet : Lister les documents.

Supprimer un document

DELETE /namespaces/:namespace/documents/:id Supprime un document, ou renvoie 404 document_not_found.

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

await docs.delete("refunds");

Response

{ "deleted": true }

Schéma complet : Supprimer un document.

Supprimer en masse

POST /namespaces/:namespace/documents/delete Supprime une liste d’ids, ou tous les documents correspondant à un filtre : envoyez ids ou filter, pas les deux.

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	Type	Rôle
`ids`	array	1 à 1 000 ids de documents ; les ids absents sont ignorés
`filter`	object	Un filtre, sans `$ne` ni `$nin`

deleted indique combien de documents cet appel a supprimés.
Un filtre supprime par lots : tant que more vaut true, renvoyez-le.

Une clé de filtre mal orthographiée ne correspond à rien, donc rien n’est supprimé.

Schéma complet : Supprimer des documents par id ou par filtre.

Premiers pas

Essentiel

Fichiers

Synchronisation

Modèles

Outils

Obtenir, lister et supprimer des documents

Obtenir un document

Lister les documents

Supprimer un document

Supprimer en masse

​Obtenir un document

​Lister les documents

​Supprimer un document

​Supprimer en masse

Obtenir un document

Lister les documents

Supprimer un document

Supprimer en masse