Manage collections

Collections는 여러 URL을 하나의 통합 지식 그래프(TKG)에 수집해 브랜드별 프라이빗 코퍼스를 구축합니다. 개인 액세스 토큰(Personal Access Token)이 필요합니다. 마스터 키는 사용할 수 없습니다.

POST /api/v1/collections

새 Collection(브랜드 코퍼스)을 생성합니다.

Request Body

string

필수

Collection 이름. 예: "Hyundai UK"

string

선택적 URL 친화적 식별자. 예: "hyundai-uk"

cURL

curl -X POST "https://api.factagora.com/api/v1/collections/{id}/answer" \
  -H "Authorization: Bearer fa_your_personal_token" \
  -H "Content-Type: application/json" \
  -d '{"question": "What is the IONIQ 6 electric range?"}'

Python

import requests

resp = requests.post(
    f"https://api.factagora.com/api/v1/collections/{collection_id}/answer",
    headers={"Authorization": "Bearer fa_your_personal_token"},
    json={"question": "What is the IONIQ 6 electric range?"},
)
data = resp.json()

TypeScript

const resp = await fetch(
  `https://api.factagora.com/api/v1/collections/${collectionId}/answer`,
  {
    method: "POST",
    headers: {
      Authorization: "Bearer fa_your_personal_token",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ question: "What is the IONIQ 6 electric range?" }),
  },
);
const data = await resp.json();

{
  "id": "5966a861-6952-482a-a9d0-041ad5d2a667",
  "name": "Hyundai UK",
  "slug": null,
  "status": "active",
  "created_at": "2026-06-29T01:34:47.817583+00:00"
}

GET /api/v1/collections

인증된 사용자의 모든 Collection 목록을 반환합니다.

curl "https://api.factagora.com/api/v1/collections" \
  -H "Authorization: Bearer fa_your_personal_token"

GET /api/v1/collections/

Collection 상세 정보와 수집된 URL 목록 및 처리 상태를 반환합니다.

curl "https://api.factagora.com/api/v1/collections/5966a861-6952-482a-a9d0-041ad5d2a667" \
  -H "Authorization: Bearer fa_your_personal_token"

{
  "id": "5966a861-6952-482a-a9d0-041ad5d2a667",
  "name": "Hyundai UK",
  "slug": null,
  "status": "active",
  "created_at": "2026-06-29T01:34:47.817583+00:00",
  "sources": [
    {
      "ingest_source_id": "a5e00acc-aa4a-4ba6-bc44-1409fe64ef81",
      "url": "https://www.hyundai.com/uk/en/models/ioniq6.html",
      "status": "completed",
      "created_at": "2026-06-29T02:00:30.000000+00:00"
    }
  ]
}

DELETE /api/v1/collections/

Collection과 연결된 모든 데이터(sources, chunks, claims, predictions, TKG)를 삭제합니다.

curl -X DELETE "https://api.factagora.com/api/v1/collections/5966a861-6952-482a-a9d0-041ad5d2a667" \
  -H "Authorization: Bearer fa_your_personal_token"

{
  "deleted": true
}

개요

Endpoints

Best Practices

Manage collections

POST /api/v1/collections

Request Body

GET /api/v1/collections

GET /api/v1/collections/

DELETE /api/v1/collections/

​POST /api/v1/collections

​Request Body

​GET /api/v1/collections

​GET /api/v1/collections/

​DELETE /api/v1/collections/

POST /api/v1/collections

Request Body

GET /api/v1/collections

GET /api/v1/collections/

DELETE /api/v1/collections/