Namespaces

Un namespace es un conjunto de documentos con nombre; la primera escritura lo crea, y uno por usuario mantiene separados los datos de cada usuario.

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

Opción	Tipo	Qué hace
`prefix`	string	Solo los namespaces cuyo nombre empieza por esto

Campo	Significado
`name`, `documents`	El namespace y cuántos documentos contiene
`embedding_model`, `rerank_model`	Los modelos que usa
`created_at`	Cuándo se creó; antes del 2026-10-18, cuándo se escribió su documento más antiguo (`null` si no contiene ninguno)
`updated_at`	Su última escritura
`last_query_at`	Su última búsqueda, registrada como máximo una vez por minuto; `null` si no se ha buscado desde el 2026-10-18

Esquema completo: Listar namespaces.

Obtener un namespace

GET /namespaces/:namespace Devuelve un namespace con los mismos campos, o 404 namespace_not_found.

curl

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

Esquema completo: Obtener un namespace.

Crear un namespace

POST /namespaces Solo es necesario para un modelo entrenado para tu organización: crea el namespace antes de su primera escritura.

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

Opción	Tipo	Qué hace
`name`	string, obligatorio	De 1 a 64 caracteres de `a-z 0-9 _ -`, empezando por una letra o un dígito
`embedding_model`	string	El id de tu modelo; por defecto, `conare-embed-1`

Devuelve name, embedding_model y rerank_model; volver a crear un namespace existente devuelve lo mismo. Esquema completo: Crear un namespace.

Eliminar un namespace

DELETE /namespaces/:namespace Elimina el namespace, todos sus documentos y sus archivos subidos; no se puede deshacer.

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

Opción	Tipo	Qué hace
`force`	boolean, por defecto `false`	Elimina también las fuentes que escriben en él

Sin force, un namespace en el que escribe una app conectada o un bucket devuelve 409 namespace_has_sources, con sus ids en details.source_ids.
sources_deleted lista las fuentes eliminadas con él; GET /sources/:id muestra deleted cuando cada una termina.

Esquema completo: Eliminar un namespace.

Primeros pasos

Esenciales

Archivos

Sincronización

Modelos

Herramientas

Listar namespaces

Obtener un namespace

Crear un namespace

Eliminar un namespace

​Listar namespaces

​Obtener un namespace

​Crear un namespace

​Eliminar un namespace

Listar namespaces

Obtener un namespace

Crear un namespace

Eliminar un namespace