Skip to main content

Quickstart

1) Create an API token​

Go to Settings → API Tokens in the Fora web app and create a personal token. Store the token securely; it is only shown once.

2) Ingest a transcript​

/ingest/items requires an API token with the ingest:write scope.

curl -X POST "https://api.fora.is/ingest/items" \
  -H "Authorization: Bearer $FORA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_type": "meeting",
    "external_id": "meeting-0001",
    "occurred_at": "2025-01-01T18:00:00Z",
    "title": "Weekly sync",
    "transcript": "We owe Alice the updated timeline by Friday.",
    "metadata": {
      "participant": "Alice",
      "channel": "zoom"
    }
  }'

Response

{
  "job_id": "5fb4d2ff-57f8-4d8c-8d89-4b8b6b6a7c1b",
  "status": "accepted",
  "idempotency_key": "...",
  "message": "Ingestion job queued for processing"
}

3) Poll for completion​

curl "https://api.fora.is/ingest/jobs/5fb4d2ff-57f8-4d8c-8d89-4b8b6b6a7c1b" \
  -H "Authorization: Bearer $FORA_TOKEN"

4) Review tasks​

curl "https://api.fora.is/tasks?status=open" \
  -H "Authorization: Bearer $FORA_TOKEN"