Namespaces

Um namespace é um conjunto nomeado de documentos; a primeira gravação o cria, e um por usuário mantém os dados dos usuários separados.

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

Opção	Tipo	O que faz
`prefix`	string	Apenas namespaces cujos nomes começam com isto

Campo	Significado
`name`, `documents`	O namespace e quantos documentos ele contém
`embedding_model`, `rerank_model`	Os modelos que ele usa
`created_at`	Quando foi criado; antes de 2026-10-18, quando seu documento mais antigo foi gravado (`null` se não contém nenhum)
`updated_at`	Sua última gravação
`last_query_at`	Sua última busca, registrada no máximo uma vez por minuto; `null` se não foi buscado desde 2026-10-18

Schema completo: Listar namespaces.

Obter um namespace

GET /namespaces/:namespace Retorna um namespace com os mesmos campos, ou 404 namespace_not_found.

curl

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

Schema completo: Obter um namespace.

Criar um namespace

POST /namespaces Só é necessário para um modelo treinado para sua organização: crie o namespace antes da primeira gravação.

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

Opção	Tipo	O que faz
`name`	string, obrigatório	De 1 a 64 caracteres de `a-z 0-9 _ -`, começando com uma letra ou dígito
`embedding_model`	string	O id do seu modelo; o padrão é `conare-embed-1`

Retorna name, embedding_model e rerank_model; criar de novo um namespace existente retorna o mesmo. Schema completo: Criar um namespace.

Excluir um namespace

DELETE /namespaces/:namespace Exclui o namespace, todos os seus documentos e seus arquivos enviados; isso não pode ser desfeito.

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

Opção	Tipo	O que faz
`force`	boolean, padrão `false`	Também exclui as fontes que gravam nele

Sem force, um namespace no qual um app conectado ou um bucket grava retorna 409 namespace_has_sources, com os ids deles em details.source_ids.
sources_deleted lista as fontes excluídas com ele; GET /sources/:id mostra deleted quando cada uma termina.

Schema completo: Excluir um namespace.

Primeiros passos

Essencial

Arquivos

Sincronização

Modelos

Ferramentas

Listar namespaces

Obter um namespace

Criar um namespace

Excluir um namespace

​Listar namespaces

​Obter um namespace

​Criar um namespace

​Excluir um namespace

Listar namespaces

Obter um namespace

Criar um namespace

Excluir um namespace