> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# 문서 조회, 목록, 삭제

> 문서 하나를 읽고, 네임스페이스를 페이지 단위로 탐색하고, id나 필터로 삭제합니다.

네임스페이스의 모든 문서를 삭제하려면 [네임스페이스를 삭제](https://docs.conare.ai/ko/namespaces.md#네임스페이스-삭제)하세요.

## 문서 조회

`GET /namespaces/:namespace/documents/:id`

전체 텍스트와 함께 문서 하나를 반환하거나, `404 document_not_found`를 반환합니다.

```bash curl theme={null}
curl https://api.conare.ai/namespaces/docs/documents/refunds \
  -H "Authorization: Bearer $CONARE_API_KEY"
```

```ts TypeScript theme={null}
const doc = await docs.get("refunds"); // null if it doesn't exist
```

```json Response theme={null}
{
  "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` | 설정된 경우 [기록](https://docs.conare.ai/ko/write.md)된 값 그대로 |

전체 스키마: [문서 조회](https://docs.conare.ai/ko/api-reference/documents/get-a-document.md).

## 문서 목록

`GET /namespaces/:namespace/documents`

텍스트 없이 id 순서로 문서를 반환합니다.

```bash curl theme={null}
curl "https://api.conare.ai/namespaces/docs/documents?limit=100" \
  -H "Authorization: Bearer $CONARE_API_KEY"
```

```ts TypeScript theme={null}
for await (const doc of docs.list()) {
  console.log(doc.id, doc.version); // reads every page
}
```

```json Response theme={null}
{
  "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`입니다 |

전체 스키마: [문서 목록](https://docs.conare.ai/ko/api-reference/documents/list-documents.md).

## 문서 삭제

`DELETE /namespaces/:namespace/documents/:id`

문서 하나를 삭제하거나, `404 document_not_found`를 반환합니다.

```bash curl theme={null}
curl -X DELETE https://api.conare.ai/namespaces/docs/documents/refunds \
  -H "Authorization: Bearer $CONARE_API_KEY"
```

```ts TypeScript theme={null}
await docs.delete("refunds");
```

```json Response theme={null}
{ "deleted": true }
```

전체 스키마: [문서 삭제](https://docs.conare.ai/ko/api-reference/documents/delete-a-document.md).

## 여러 문서 삭제

`POST /namespaces/:namespace/documents/delete`

id 목록 또는 필터와 일치하는 모든 문서를 삭제합니다. `ids`나 `filter` 중 하나만 보내세요.

```bash curl theme={null}
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"}}'
```

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

```json Response theme={null}
{ "deleted": 2, "more": false }
```

| 옵션 | 유형 | 설명 |
| - | - | - |
| `ids` | array | 문서 id 1-1,000개. 없는 id는 건너뜁니다 |
| `filter` | object | `$ne`나 `$nin`이 없는 [필터](https://docs.conare.ai/ko/filters.md) |

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

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

전체 스키마: [id 또는 필터로 문서 삭제](https://docs.conare.ai/ko/api-reference/documents/delete-documents-by-id-or-filter.md).


## Related topics

- [네임스페이스](https://docs.conare.ai/ko/namespaces.md)
- [turbopuffer API](https://docs.conare.ai/ko/turbopuffer.md)
- [소스](https://docs.conare.ai/ko/sources.md)
- [TypeScript SDK](https://docs.conare.ai/ko/sdk.md)
- [필터](https://docs.conare.ai/ko/filters.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.