Ottenere, elencare ed eliminare documenti

Per eliminare tutto in un namespace, elimina il namespace.

Ottenere un documento

GET /namespaces/:namespace/documents/:id Restituisce un documento con il suo testo completo, oppure 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
}

Campo	Significato
`id`, `text`, `metadata`	Il documento
`updated_at`	Quando è cambiato l’ultima volta, in UTC
`version`	Aumenta a ogni modifica
`user`, `seq`	Come scritti, se impostati

Schema completo: Ottenere un documento.

Elencare i documenti

GET /namespaces/:namespace/documents Restituisce i documenti in ordine di id, senza il loro testo.

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
}

Opzione	Tipo	Cosa fa
`limit`	integer, predefinito 50	Documenti per pagina, 1-100
`cursor`	string	Il `next_cursor` della pagina precedente, che è `null` nell’ultima pagina

Schema completo: Elencare i documenti.

Eliminare un documento

DELETE /namespaces/:namespace/documents/:id Elimina un documento, oppure restituisce 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 }

Schema completo: Eliminare un documento.

Eliminarne molti

POST /namespaces/:namespace/documents/delete Elimina un elenco di id, o tutti i documenti che corrispondono a un filtro: invia ids oppure filter, non entrambi.

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 }

Opzione	Tipo	Cosa fa
`ids`	array	Da 1 a 1.000 id di documenti; gli id mancanti vengono ignorati
`filter`	object	Un filtro, senza `$ne` o `$nin`

deleted indica quanti documenti ha eliminato questa chiamata.
Un filtro elimina a lotti: finché more è true, invialo di nuovo.

Una chiave di filtro scritta male non corrisponde a nulla, quindi non viene eliminato nulla.

Schema completo: Eliminare documenti per id o filtro.

Primi passi

Fondamenti

File

Sincronizzazione

Modelli

Strumenti

Ottenere, elencare ed eliminare documenti

Ottenere un documento

Elencare i documenti

Eliminare un documento

Eliminarne molti

​Ottenere un documento

​Elencare i documenti

​Eliminare un documento

​Eliminarne molti

Ottenere un documento

Elencare i documenti

Eliminare un documento

Eliminarne molti