문서 조회, 목록, 삭제

네임스페이스의 모든 문서를 삭제하려면 네임스페이스를 삭제하세요.

문서 조회

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	문서 id 1-1,000개. 없는 id는 건너뜁니다
`filter`	object	`$ne`나 `$nin`이 없는 필터

deleted는 이 호출이 삭제한 개수입니다.
필터는 배치 단위로 삭제합니다. more가 true인 동안 다시 보내세요.

필터 키의 철자가 틀리면 아무것도 일치하지 않으므로, 아무것도 삭제되지 않습니다.

전체 스키마: id 또는 필터로 문서 삭제.

시작하기

핵심

파일

동기화

모델

도구

문서 조회, 목록, 삭제

문서 조회

문서 목록

문서 삭제

여러 문서 삭제

​문서 조회

​문서 목록

​문서 삭제

​여러 문서 삭제

문서 조회

문서 목록

문서 삭제

여러 문서 삭제