ドキュメントの取得、一覧表示、削除

ネームスペース内のすべてを削除するには、ネームスペースを削除してください。

ドキュメントを取得する

GET /namespaces/:namespace/documents/:id 全文を含むドキュメントを 1 件返します。見つからない場合は 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 ページあたりのドキュメント数(1〜100)
`cursor`	string	前のページの `next_cursor`。最後のページでは `null` です

完全なスキーマ: ドキュメントを一覧表示する。

ドキュメントを削除する

DELETE /namespaces/:namespace/documents/:id ドキュメントを 1 件削除します。見つからない場合は 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 またはフィルターでドキュメントを削除する。

はじめに

コア

ファイル

同期

モデル

ツール

ドキュメントの取得、一覧表示、削除

ドキュメントを取得する

ドキュメントを一覧表示する

ドキュメントを削除する

まとめて削除する

​ドキュメントを取得する

​ドキュメントを一覧表示する

​ドキュメントを削除する

​まとめて削除する

ドキュメントを取得する

ドキュメントを一覧表示する

ドキュメントを削除する

まとめて削除する