API Reference
Translato provides a RESTful API for custom integrations and automation. This document lists the primary endpoints and their functions.
1. Authentication
All requests must include either a session cookie (for the web app) or an X-API-Key header (for CLI/SDKs).
curl -H "X-API-Key: tlto_live_..." https://api.yourdomain.com/api/projects
2. Endpoints Catalog
Authentication (/api/auth)
| Method | Path | Description |
|---|---|---|
| POST | /login | Login (returns 2FA challenge if enabled) |
| POST | /refresh | Rotate access + refresh tokens |
| GET | /me | Get current user details |
| POST | /logout | Logout the current session |
Projects (/api/projects)
| Method | Path | Description |
|---|---|---|
| GET | / | List all projects you have access to |
| POST | / | Create a new project |
| GET | /:id | Get project details, languages, and stats |
| PATCH | /:id | Update project settings |
| DELETE | /:id | Delete a project |
Terms & Translations
| Method | Path | Description |
|---|---|---|
| GET | /api/projects/:projectId/terms | List all keys (paginated) |
| POST | /api/projects/:projectId/terms | Create or upsert terms |
| GET | /api/projects/:projectId/translations | Get values for a specific language |
| POST | /api/projects/:projectId/translations | Create or update translations |
VCS & Automation
| Method | Path | Description |
|---|---|---|
| POST | /api/projects/:projectId/vcs/sync | Trigger a manual repository sync |
| POST | /api/projects/:projectId/vcs/push | Push translations and create a PR |
| GET | /api/projects/:projectId/tm/suggest | Get Translation Memory suggestions |
3. POEditor Compatibility
Translato offers a drop-in replacement for the POEditor v2 API. Simply point your existing tools to /api/v2.
POST /api/v2/projects/listPOST /api/v2/terms/addPOST /api/v2/projects/export
4. Swagger / OpenAPI
For a complete, interactive list of all endpoints, parameters, and response schemas, visit:
https://api.yourdomain.com/documentation