Namespace

Un namespace è un insieme di documenti con un nome; la prima scrittura lo crea, e uno per utente tiene separati i dati degli utenti.

Elencare i namespace

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"
    }
  ]
}

Opzione	Tipo	Cosa fa
`prefix`	string	Solo i namespace il cui nome inizia con questo valore

Campo	Significato
`name`, `documents`	Il namespace e quanti documenti contiene
`embedding_model`, `rerank_model`	I modelli che usa
`created_at`	Quando è stato creato; prima del 2026-10-18, quando è stato scritto il suo documento più vecchio (`null` se non ne contiene)
`updated_at`	La sua ultima scrittura
`last_query_at`	La sua ultima ricerca, registrata al massimo una volta al minuto; `null` se non è stato cercato dal 2026-10-18

Schema completo: Elencare i namespace.

Ottenere un namespace

GET /namespaces/:namespace Restituisce un namespace con gli stessi campi, oppure 404 namespace_not_found.

curl

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

Schema completo: Ottenere un namespace.

Creare un namespace

POST /namespaces Serve solo per un modello addestrato per la tua organizzazione: crea il namespace prima della sua prima scrittura.

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>"}'

Opzione	Tipo	Cosa fa
`name`	string, obbligatorio	1-64 caratteri tra `a-z 0-9 _ -`, che inizia con una lettera o una cifra
`embedding_model`	string	L’id del tuo modello; predefinito `conare-embed-1`

Restituisce name, embedding_model e rerank_model; creare di nuovo un namespace esistente restituisce lo stesso risultato. Schema completo: Creare un namespace.

Eliminare un namespace

DELETE /namespaces/:namespace Elimina il namespace, tutti i suoi documenti e i suoi file caricati; l’operazione non può essere annullata.

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"] }

Opzione	Tipo	Cosa fa
`force`	boolean, predefinito `false`	Elimina anche le sorgenti che vi scrivono

Senza force, un namespace in cui scrive un’app collegata o un bucket restituisce 409 namespace_has_sources, con i loro id in details.source_ids.
sources_deleted elenca le sorgenti eliminate insieme al namespace; GET /sources/:id mostra deleted quando ciascuna è completata.

Schema completo: Eliminare un namespace.

Primi passi

Fondamenti

File

Sincronizzazione

Modelli

Strumenti

Elencare i namespace

Ottenere un namespace

Creare un namespace

Eliminare un namespace

​Elencare i namespace

​Ottenere un namespace

​Creare un namespace

​Eliminare un namespace

Elencare i namespace

Ottenere un namespace

Creare un namespace

Eliminare un namespace