Manage collections

Collections let you build a per-brand private corpus by ingesting multiple URLs into one unified knowledge graph (TKG). Requires a personal access token. Master keys are rejected.

POST /api/v1/collections

Create a new collection (brand corpus).

Request Body

string

required

Collection name, e.g. "Hyundai UK".

string

Optional URL-friendly identifier, e.g. "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

List all collections owned by the authenticated user.

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

GET /api/v1/collections/

Get a collection including its ingested URL list and their processing status.

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/

Delete a collection and all its associated data (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
}

Overview

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/