네임스페이스

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

네임스페이스 목록

GET /namespaces

curl "https://api.conare.ai/namespaces?prefix=user-" \
  -H "Authorization: Bearer $CONARE_API_KEY"

await conare.namespaces({ prefix: "user-" });

Response

{
  "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`

전체 스키마: 네임스페이스 목록.

네임스페이스 조회

GET /namespaces/:namespace 같은 필드로 네임스페이스 하나를 반환하거나, 404 namespace_not_found를 반환합니다.

curl

curl https://api.conare.ai/namespaces/user-42 \
  -H "Authorization: Bearer $CONARE_API_KEY"

전체 스키마: 네임스페이스 조회.

네임스페이스 생성

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

curl

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	모델의 id. 기본값은 `conare-embed-1`

name, embedding_model, rerank_model을 반환하며, 기존 네임스페이스를 다시 생성해도 같은 값을 반환합니다. 전체 스키마: 네임스페이스 생성.

네임스페이스 삭제

DELETE /namespaces/:namespace 네임스페이스와 그 안의 모든 문서, 업로드된 파일을 삭제합니다. 되돌릴 수 없습니다.

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

await conare.namespace("docs").drop();

Response

{ "deleted": true, "sources_deleted": ["src_01139ca8ca59f2556f65b60e"] }

옵션	유형	설명
`force`	boolean, 기본값 `false`	여기에 쓰는 소스도 함께 삭제

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

전체 스키마: 네임스페이스 삭제.

시작하기

핵심

파일

동기화

모델

도구

네임스페이스

네임스페이스 목록

네임스페이스 조회

네임스페이스 생성

네임스페이스 삭제

​네임스페이스 목록

​네임스페이스 조회

​네임스페이스 생성

​네임스페이스 삭제

네임스페이스 목록

네임스페이스 조회

네임스페이스 생성

네임스페이스 삭제