fora

Documentation

Fora docs

Fora translates your Postgres content — text and images — at write time. Your read path stays zero-overhead. Start with the API or deploy the connector to skip all per-row code.

Getting started

15 min

Create an account, submit your first translation job, and handle the webhook callback. Under 15 minutes.

Image translation

10 min

Inpaint translated text directly into images — signs, banners, product listings. Requires S3-compatible storage.

Postgres connector

30 min

Deploy the connector, point it at your database with a config file, and get locale-transparent views with no app code changes.

API reference

Reference

Full endpoint reference rendered live from the deployed OpenAPI spec. Browse schemas, request/response shapes, and try public endpoints in-page.

Verifying webhooks

5 min

Verify Fora-Signature with HMAC-SHA256 and dedupe on Fora-Event-Id. Node + Python snippets pinned to a fixed test vector.

Quick reference

1. Get an API key

Sign up at dashboard.getfora.ai

2. Submit a translation job

curl -X POST https://api.getfora.ai/v1/translate \
  -H "Authorization: Bearer $FORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_text": "Welcome.", "target_locales": ["es", "fr"]}'

3. Poll for the result

curl "https://api.getfora.ai/v1/content/{job_id}?locale=es" \
  -H "Authorization: Bearer $FORA_API_KEY"

API reference

POST/v1/accountsCreate account + get API key
POST/v1/translateSubmit translation job (text + images)
GET/v1/content/{id}Poll job result by locale
POST/v1/accounts/storageConfigure S3/R2 bucket for images
POST/connectorsRegister Postgres connector
GET/connectorsList connectors

Base URL: https://api.getfora.ai

Auth: Authorization: Bearer {api_key}