GET
/
v1
/
rag42
/
collections
컬렉션 목록
curl --request GET \
  --url https://api.clovastudio.go.kr/v1/rag42/collections \
  --header 'Authorization: Bearer <token>'
{
  "status": {
    "code": "20000",
    "message": "OK"
  },
  "result": {
    "collections": [
      {
        "collection_id": "ef7483af16d84818a59dcbcf8b587b93",
        "collection_name": "행정문서_2024",
        "visibility": "private",
        "is_owner": true,
        "created_at": "2024-01-15T09:00:00Z",
        "updated_at": "2024-10-18T10:30:00Z",
        "search_config": {
          "mode": "hybrid",
          "alpha": 0.5
        },
        "ingest_config": {
          "chunking_strategy": "by_length",
          "chunk_size": 2000,
          "chunk_overlap": 200,
          "embedding_model": "bge-m3",
          "embedding_dimension": 1024,
          "pii_mask": true,
          "parser_model": "rag42-chunk-v1",
          "indexed_fields": [
            "author",
            "department",
            "document_type"
          ],
          "external_id_field": "document_number"
        }
      },
      {
        "collection_id": "a1b2c3d4e5f6789012345678",
        "collection_name": "규정집_2024",
        "visibility": "public",
        "is_owner": false,
        "created_at": "2024-02-20T14:20:00Z",
        "updated_at": "2024-09-05T16:45:00Z",
        "search_config": {
          "mode": "vector",
          "alpha": 1
        },
        "ingest_config": {
          "chunking_strategy": "by_title",
          "chunk_size": 1000,
          "chunk_overlap": 100,
          "embedding_model": "rag42-embed-v1",
          "embedding_dimension": 1024,
          "pii_mask": false,
          "parser_model": "lomin-layout-v1",
          "indexed_fields": [
            "category",
            "regulation_number"
          ]
        }
      }
    ],
    "total_count": 2
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

CSG-TENANT-ID
string | null

Clova Studio Gov 테넌트 ID

X-CSG-TENANT-ID
string | null

Clova Studio Gov 테넌트 ID (레거시)

Query Parameters

size
integer | null
default:20

반환할 컬렉션 수

Required range: 1 <= x <= 100
from
integer | null
default:0

시작 위치 (0부터)

Required range: x >= 0
sort
string | null
default:created_at:desc

정렬 옵션 (name:asc, name:desc, created_at:asc, created_at:desc)

visibility
string | null
default:all

컬렉션 공개 여부 필터 (all: 전체, public: 공개만, private: 비공개만)

Response

컬렉션 목록 조회 성공

status
object
required

응답 상태

result
object
required

컬렉션 목록 조회 결과