Namespaces

Un namespace est un ensemble nommé de documents ; la première écriture le crée, et un namespace par utilisateur sépare leurs données.

Lister les namespaces

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	Type	Rôle
`prefix`	string	Seulement les namespaces dont le nom commence ainsi

Champ	Signification
`name`, `documents`	Le namespace et le nombre de documents qu’il contient
`embedding_model`, `rerank_model`	Les modèles qu’il utilise
`created_at`	Sa date de création ; avant le 2026-10-18, la date d’écriture de son plus ancien document (`null` s’il est vide)
`updated_at`	Sa dernière écriture
`last_query_at`	Sa dernière recherche, enregistrée au plus une fois par minute ; `null` s’il n’a pas été interrogé depuis le 2026-10-18

Schéma complet : Lister les namespaces.

Obtenir un namespace

GET /namespaces/:namespace Renvoie un namespace avec les mêmes champs, ou 404 namespace_not_found.

curl

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

Schéma complet : Obtenir un namespace.

Créer un namespace

POST /namespaces Nécessaire uniquement pour un modèle entraîné pour votre organisation : créez le namespace avant sa première écriture.

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	Type	Rôle
`name`	string, obligatoire	1 à 64 caractères parmi `a-z 0-9 _ -`, commençant par une lettre ou un chiffre
`embedding_model`	string	L’id de votre modèle ; `conare-embed-1` par défaut

Renvoie name, embedding_model et rerank_model ; recréer un namespace existant renvoie la même chose. Schéma complet : Créer un namespace.

Supprimer un namespace

DELETE /namespaces/:namespace Supprime le namespace, tous ses documents et ses fichiers importés ; c’est irréversible.

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	Type	Rôle
`force`	boolean, `false` par défaut	Supprimer aussi les sources qui y écrivent

Sans force, un namespace alimenté par une application connectée ou un bucket renvoie 409 namespace_has_sources, avec leurs ids dans details.source_ids.
sources_deleted liste les sources supprimées avec lui ; GET /sources/:id affiche deleted une fois chacune supprimée.

Schéma complet : Supprimer un namespace.

Premiers pas

Essentiel

Fichiers

Synchronisation

Modèles

Outils

Lister les namespaces

Obtenir un namespace

Créer un namespace

Supprimer un namespace

​Lister les namespaces

​Obtenir un namespace

​Créer un namespace

​Supprimer un namespace

Lister les namespaces

Obtenir un namespace

Créer un namespace

Supprimer un namespace