Отримання, перелік і видалення документів

Щоб видалити все в просторі імен, видаліть простір імен.

Отримайте документ

GET /namespaces/:namespace/documents/:id Повертає один документ із повним текстом або 404 document_not_found.

curl https://api.conare.ai/namespaces/docs/documents/refunds \
  -H "Authorization: Bearer $CONARE_API_KEY"

const doc = await docs.get("refunds"); // null if it doesn't exist

Response

{
  "id": "refunds",
  "text": "Refunds are available for 30 days.",
  "metadata": { "team": "support" },
  "updated_at": "2026-10-21T21:38:52Z",
  "version": 1
}

Поле	Значення
`id`, `text`, `metadata`	Документ
`updated_at`	Коли він востаннє змінився, в UTC
`version`	Зростає з кожною зміною
`user`, `seq`	Як під час запису, якщо задано

Повна схема: Отримати документ.

Перелік документів

GET /namespaces/:namespace/documents Повертає документи в порядку id, без їхнього тексту.

curl "https://api.conare.ai/namespaces/docs/documents?limit=100" \
  -H "Authorization: Bearer $CONARE_API_KEY"

for await (const doc of docs.list()) {
  console.log(doc.id, doc.version); // reads every page
}

Response

{
  "documents": [
    { "id": "refunds", "metadata": { "team": "support" }, "updated_at": "2026-10-21T21:38:52Z", "version": 1 },
    { "id": "shipping", "metadata": { "team": "ops" }, "updated_at": "2026-10-21T21:38:52Z", "version": 1 }
  ],
  "next_cursor": null
}

Параметр	Тип	Що робить
`limit`	integer, за замовчуванням 50	Документів на сторінку, 1-100
`cursor`	string	`next_cursor` попередньої сторінки, який на останній сторінці дорівнює `null`

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

Видаліть документ

DELETE /namespaces/:namespace/documents/:id Видаляє один документ або повертає 404 document_not_found.

curl -X DELETE https://api.conare.ai/namespaces/docs/documents/refunds \
  -H "Authorization: Bearer $CONARE_API_KEY"

await docs.delete("refunds");

Response

{ "deleted": true }

Повна схема: Видалити документ.

Видаліть кілька

POST /namespaces/:namespace/documents/delete Видаляє список id або всі документи, що відповідають фільтру: надішліть ids або filter, але не обидва.

curl https://api.conare.ai/namespaces/docs/documents/delete \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["refunds", "shipping"]}'

curl https://api.conare.ai/namespaces/docs/documents/delete \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter": {"team": "support"}}'

await docs.deleteMany(["refunds", "shipping"]); // how many were deleted
await docs.deleteWhere({ team: "support" });    // repeats until done

Response

{ "deleted": 2, "more": false }

Параметр	Тип	Що робить
`ids`	array	1-1 000 id документів; відсутні id пропускаються
`filter`	object	Фільтр без `$ne` чи `$nin`

deleted — скільки документів видалив цей виклик.
Фільтр видаляє пакетами: поки more дорівнює true, надсилайте його знову.

Ключ фільтра з помилкою в назві нічому не відповідає, тож нічого не видаляється.

Повна схема: Видалити документи за id або фільтром.

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

Основне

Файли

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

Моделі

Інструменти

Отримання, перелік і видалення документів

Отримайте документ

Перелік документів

Видаліть документ

Видаліть кілька

​Отримайте документ

​Перелік документів

​Видаліть документ

​Видаліть кілька

Отримайте документ

Перелік документів

Видаліть документ

Видаліть кілька