Простори імен

Простір імен — це іменований набір документів; перший запис створює його, а окремий простір для кожного користувача тримає дані користувачів окремо.

Перелік просторів імен

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

Параметр	Тип	Що робить
`prefix`	string	Лише простори імен, назви яких починаються з цього

Поле	Значення
`name`, `documents`	Простір імен і кількість документів у ньому
`embedding_model`, `rerank_model`	Моделі, які він використовує
`created_at`	Коли його створено; до 2026-10-18 — коли записано його найстаріший документ (`null`, якщо документів немає)
`updated_at`	Його останній запис
`last_query_at`	Його останній пошук, фіксується не частіше ніж раз на хвилину; `null`, якщо пошуку не було з 2026-10-18

Повна схема: Перелік просторів імен.

Отримайте простір імен

GET /namespaces/:namespace Повертає один простір імен з тими самими полями або 404 namespace_not_found.

curl

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

Повна схема: Отримати простір імен.

Створіть простір імен

POST /namespaces Потрібно лише для моделі, навченої для вашої організації: створіть простір імен до першого запису.

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

Параметр	Тип	Що робить
`name`	string, обов’язковий	1-64 символи з `a-z 0-9 _ -`, починається з літери або цифри
`embedding_model`	string	Id вашої моделі; за замовчуванням `conare-embed-1`

Повертає name, embedding_model і rerank_model; повторне створення наявного простору імен повертає те саме. Повна схема: Створити простір імен.

Видаліть простір імен

DELETE /namespaces/:namespace Видаляє простір імен, усі його документи та завантажені файли; це неможливо скасувати.

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

Параметр	Тип	Що робить
`force`	boolean, за замовчуванням `false`	Також видалити джерела, що записують у нього

Без force простір імен, у який записує підключений застосунок або бакет, повертає 409 namespace_has_sources з їхніми id у details.source_ids.
sources_deleted перелічує джерела, видалені разом із ним; GET /sources/:id показує deleted, коли кожне з них видалено.

Повна схема: Видалити простір імен.

Початок роботи

Основне

Файли

Синхронізація

Моделі

Інструменти

Простори імен

Перелік просторів імен

Отримайте простір імен

Створіть простір імен

Видаліть простір імен

​Перелік просторів імен

​Отримайте простір імен

​Створіть простір імен

​Видаліть простір імен

Перелік просторів імен

Отримайте простір імен

Створіть простір імен

Видаліть простір імен