Changelog¶

All notable changes to the Falara API. Newest entries first.

March 22, 2026 -- Quality Selector & Session Persistence¶

Quality levels -- Choose between Standard (Claude Sonnet) and Premium (Claude Opus) translation quality via the quality field
project_name field on all job creation endpoints for organizing translations
billed_words in job results reflecting quality multiplier
Session persistence in the web portal (Translate + File Translate)

Job archiving -- PATCH /v1/jobs/{id}/archive, PATCH /v1/jobs/{id}/unarchive, POST /v1/jobs/archive-all, POST /v1/jobs/archive-batch
Google Drive delivery -- POST /v1/jobs/{id}/deliver for manual re-delivery
Monitoring dashboard (internal)

Google Drive integration -- Connect your Drive, translate files directly via POST /v1/services/google-drive/jobs
OAuth flow -- GET /v1/integrations/google/connect, /status, /disconnect, /picker-token
Structure templates -- CRUD for content creation schemas (/v1/structure-templates)
Template from file -- POST /v1/structure-templates/from-file to derive templates from documents
CSV batch -- POST /v1/jobs/batch-csv for bulk content creation

Style references -- CRUD endpoints at /v1/style-references for tone and voice guidelines
Glossary bulk import -- POST /v1/glossaries/upload/preview + /commit for TBX, CSV, Excel files
Webhook CRUD -- GET/PUT/DELETE /v1/webhooks/config for self-service webhook management
CSV mappings -- CRUD at /v1/csv-mappings for CSV column mapping

Webhook events -- job.completed, job.failed, job.needs_review, batch.completed
HMAC-SHA256 signing with replay protection (X-Falara-Signature, X-Falara-Timestamp)
Automatic retries with exponential backoff (5 attempts over ~2.5 hours)
Duplicate-event protection -- each (job_id, event) pair delivered at most once
SSRF protection -- webhook URLs are validated against internal networks

Text translation -- POST /v1/jobs with inline text or list of texts
File translation -- POST /v1/jobs/file supporting HTML, Markdown, DOCX, XLSX, PPTX, XLIFF 1.2/2.0, JSON
Multi-language batch -- POST /v1/jobs/batch-text and POST /v1/jobs/batch-file with ZIP download
Glossary management -- CRUD at /v1/glossaries with inline and stored entries
Job monitoring -- GET /v1/jobs, GET /v1/jobs/{id}, GET /v1/jobs/{id}/result
API key management -- POST /v1/api-keys, GET /v1/api-keys, DELETE /v1/api-keys/{hash}
Account management -- GET /v1/account, PATCH /v1/account
GDPR data deletion -- DELETE /v1/account/data
Cursor-based pagination across all list endpoints
Source Review -- optional source text quality checking before translation