> ## 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.

# 네임스페이스

> 네임스페이스 목록, 조회, 생성, 삭제: docs나 user-42처럼 이름이 붙은 문서 집합.

네임스페이스는 이름이 붙은 문서 집합입니다. 첫 쓰기에서 생성되며, 사용자마다 하나씩 두면 사용자 데이터를 분리할 수 있습니다.

## 네임스페이스 목록

`GET /namespaces`

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

```ts TypeScript theme={null}
await conare.namespaces({ prefix: "user-" });
```

```json Response theme={null}
{
  "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` | 마지막 검색, 최대 1분에 한 번 기록. 2026-10-18 이후 검색되지 않았으면 `null` |

전체 스키마: [네임스페이스 목록](https://docs.conare.ai/ko/api-reference/namespaces/list-namespaces.md).

## 네임스페이스 조회

`GET /namespaces/:namespace`

같은 필드로 네임스페이스 하나를 반환하거나, `404 namespace_not_found`를 반환합니다.

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

전체 스키마: [네임스페이스 조회](https://docs.conare.ai/ko/api-reference/namespaces/get-a-namespace.md).

## 네임스페이스 생성

`POST /namespaces`

조직용으로 학습된 모델을 쓸 때만 필요합니다. 첫 쓰기 전에 네임스페이스를 생성하세요.

```bash curl theme={null}
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, 필수 | `a-z 0-9 _ -`로 된 1-64자, 문자나 숫자로 시작 |
| `embedding_model` | string | [모델](https://docs.conare.ai/ko/embed-rerank.md#모델)의 id. 기본값은 `conare-embed-1` |

`name`, `embedding_model`, `rerank_model`을 반환하며, 기존 네임스페이스를 다시 생성해도 같은 값을 반환합니다. 전체 스키마: [네임스페이스 생성](https://docs.conare.ai/ko/api-reference/namespaces/create-a-namespace.md).

## 네임스페이스 삭제

`DELETE /namespaces/:namespace`

네임스페이스와 그 안의 모든 문서, [업로드된 파일](https://docs.conare.ai/ko/files.md)을 삭제합니다. 되돌릴 수 없습니다.

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

```ts TypeScript theme={null}
await conare.namespace("docs").drop();
```

```json Response theme={null}
{ "deleted": true, "sources_deleted": ["src_01139ca8ca59f2556f65b60e"] }
```

| 옵션 | 유형 | 설명 |
| - | - | - |
| `force` | boolean, 기본값 `false` | 여기에 쓰는 [소스](https://docs.conare.ai/ko/sources.md)도 함께 삭제 |

* `force` 없이 연결된 앱이나 버킷이 쓰는 네임스페이스를 삭제하면 `409 namespace_has_sources`를 반환하며, 해당 id는 `details.source_ids`에 있습니다.
* `sources_deleted`는 함께 삭제된 소스 목록입니다. 각각 완료되면 `GET /sources/:id`에 `deleted`가 표시됩니다.

전체 스키마: [네임스페이스 삭제](https://docs.conare.ai/ko/api-reference/namespaces/delete-a-namespace.md).


## Related topics

- [검색](https://docs.conare.ai/ko/query.md)
- [MCP](https://docs.conare.ai/ko/mcp-server.md)
- [콘솔](https://docs.conare.ai/ko/console.md)
- [문서 조회, 목록, 삭제](https://docs.conare.ai/ko/documents.md)
- [문서 쓰기](https://docs.conare.ai/ko/write.md)


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