For Agents
Manage translation projects, upload source files, configure locales, assign translation jobs, and download localized content in multiple formats through Phrase's localization platform.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Phrase API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Phrase API.
Create and configure translation projects with multiple target locales and file format support
Upload source files for string extraction and translation key generation
Manage translation keys with tags, descriptions, and pluralization rules
GET STARTED
Use for: I need to create a new translation project in Phrase, I want to upload a source file for translation, Download the translated strings for a specific locale, List all translation keys in a project that are untranslated
Not supported: Does not handle machine translation, terminology databases, or translation memory matching — use for translation project management and file exchange only.
Jentic publishes the only available OpenAPI specification for Phrase API, keeping it validated and agent-ready. Phrase provides a translation management system API for multi-language content workflows including project management, translation key organization, locale configuration, job tracking, file uploads, and translation downloads. The API supports 15 endpoints covering the complete localization lifecycle from source string extraction through translator assignment to final export in multiple file formats.
Download translated content in format-specific exports (JSON, XLIFF, Android XML, iOS strings)
Assign translation jobs to translators with deadlines and status tracking
Configure locale-specific settings including fallback languages and completion thresholds
Patterns agents use Phrase API for, with concrete tasks.
★ Continuous Localization Pipeline
Automate the localization cycle by uploading source files to Phrase whenever code deploys, tracking translation progress per locale, and downloading completed translations for integration into the build pipeline. Phrase handles string extraction, key deduplication, and translator notification automatically. Supports CI/CD integration where new strings are detected on every push and translated content is pulled before each release.
Upload a JSON source file to project PROJECT123 via POST /projects/{project_id}/uploads, then check locale completion status with GET /projects/{project_id}/locales
Multi-Platform Translation Export
Export translated content in platform-specific formats for simultaneous deployment across web, iOS, and Android. Phrase stores translations in a format-agnostic key-value structure and exports to JSON (web), Localizable.strings (iOS), strings.xml (Android), XLIFF, and other formats. A single source of truth serves all platforms without manual format conversion.
Download translations for locale 'de' from project PROJECT123 in Android XML format via GET /projects/{project_id}/downloads with format parameter set to xml
Translation Job Management
Assign translation tasks to specific translators or teams with deadlines and scope definitions. Jobs in Phrase track which keys need translation, who is responsible, and the current progress. Project managers can monitor completion rates per job and locale to identify bottlenecks before release deadlines.
Create a translation job for all untranslated keys in locale 'fr' of project PROJECT123 using POST /projects/{project_id}/jobs with a deadline of next Friday
AI Agent Localization Workflow via Jentic
AI agents managing product releases can automate the localization workflow through Jentic — uploading new source strings, checking translation completeness per locale, and downloading finished translations for deployment. Jentic handles bearer token authentication and Phrase API discovery so agents can focus on the workflow logic rather than API integration details.
Search Jentic for 'upload source file for translation', load the Phrase upload operation, execute with a JSON file, then check completion status for all configured locales
15 endpoints — jentic publishes the only available openapi specification for phrase api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/projects
List all translation projects
/projects
Create a new translation project
/projects/{project_id}/keys
List translation keys in a project
/projects/{project_id}/translations
List translations for a project
/projects/{project_id}/locales
List configured locales for a project
/projects/{project_id}/uploads
Upload a source file for translation
/projects/{project_id}/downloads
Download translated files in specified format
/projects/{project_id}/jobs
List translation jobs in a project
/projects
List all translation projects
/projects
Create a new translation project
/projects/{project_id}/keys
List translation keys in a project
/projects/{project_id}/translations
List translations for a project
/projects/{project_id}/locales
List configured locales for a project
Three things that make agents converge on Jentic-routed access.
Credential isolation
Phrase API tokens are stored encrypted in the Jentic MAXsystem vault. Agents receive the Authorization header with the token prefix injected at execution time — raw API tokens never enter the agent context.
Intent-based discovery
Agents search by intent (e.g., 'upload source file for translation') and Jentic returns matching Phrase operations with their input schemas including project ID requirements, file format parameters, and locale specifications.
Time to first call
Direct Phrase integration: 2-3 days for auth setup, file upload handling, and format-specific export configuration. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Phrase API through Jentic.
Why is there no official OpenAPI spec for Phrase API?
Phrase does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Phrase API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Phrase API use?
Phrase supports two authentication methods: Bearer token authentication and API token authentication via the Authorization header with format 'token YOUR_TOKEN'. API tokens are generated in the Phrase dashboard. Through Jentic, tokens are stored in the MAXsystem vault and injected into request headers automatically.
Can I upload source files in multiple formats to Phrase?
Yes. The POST /projects/{project_id}/uploads endpoint accepts various source file formats including JSON, YAML, XLIFF, Android XML, iOS Localizable.strings, and many more. Phrase automatically extracts translation keys from the uploaded file structure.
How do I download translations in a specific file format?
Use GET /projects/{project_id}/downloads with the locale and format parameters. Supported export formats include JSON, XLIFF, Android XML, iOS strings, Ruby YAML, PHP, and others. The response contains the translated file ready for integration into your build pipeline.
How do I automate localization uploads through Jentic?
Search Jentic for 'upload source file for translation' to find the POST /projects/{project_id}/uploads operation. Load the schema to see accepted file formats and parameters, then execute with your source file. Jentic handles token authentication and multipart upload formatting.
Can I track translation completion per locale?
Yes. Use GET /projects/{project_id}/locales to retrieve all configured locales with their completion statistics. Each locale entry includes the total key count, translated count, and completion percentage, letting you identify which languages need attention before release.
/projects/{project_id}/uploads
Upload a source file for translation
/projects/{project_id}/downloads
Download translated files in specified format
/projects/{project_id}/jobs
List translation jobs in a project