Install Jentic One Beta

Connect the Localizely API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Localizely 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Flocalizely.com%2Flocalizely" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Flocalizely.com%2Flocalizely" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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.

Capabilities

What an agent can do with Localizely API.

Upload localization files into a Localizely project for translation

Download translated files in the source format for build-time consumption

Create a branch in a project to isolate work-in-progress translations

Check the translation status of a project to gate releases on completion

Authenticate with an admin-role API token via the X-API-Token header

GET STARTED

Start building with Localizely API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Localizely API for, with concrete tasks.

★ Translation File CI Pipeline

Engineering teams that ship localised apps want translations pulled into the build at CI time. Localizely's download endpoint returns the latest translation file in the source format, and the status endpoint exposes per-language completion. A CI step calls download for each release and optionally fails the build if a key language is below threshold.

Call GET /v1/projects/{project_id}/files/download for each language in the build, check GET /v1/projects/{project_id}/status, and fail if completion is below the configured threshold.

Source String Upload from Source Control

When developers add new strings to the codebase, those strings need to land in Localizely so translators can pick them up. POST /v1/projects/{project_id}/files/upload accepts the source localization file. Combined with the branch endpoint, teams can isolate new strings on a feature branch until they are ready for production translators.

Call POST /v1/projects/{project_id}/branches/{branch} to create a feature branch then POST /v1/projects/{project_id}/files/upload with the new source strings.

AI Agent Release Gate

An AI agent running release checks can call Localizely through Jentic to confirm translations are complete before approving a deployment. The agent searches Jentic for the status operation, executes it with the project ID, and reports back per-language completion. The API token stays in your Jentic One instance.

Use Jentic to call GET /v1/projects/{project_id}/status and report any language below 95% complete to the deployment workflow.

Key Endpoints

4 endpoints — jentic publishes the only available openapi specification for localizely api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/v1/projects/{project_id}/files/upload

Upload a localization file

GET

/v1/projects/{project_id}/files/download

Download translated files

POST

/v1/projects/{project_id}/branches/{branch}

Create a project branch

GET

/v1/projects/{project_id}/status

Get translation completion status

POST

/v1/projects/{project_id}/files/upload

Upload a localization file

GET

/v1/projects/{project_id}/files/download

Download translated files

POST

/v1/projects/{project_id}/branches/{branch}

Create a project branch

GET

/v1/projects/{project_id}/status

Get translation completion status

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Localizely API by hand means setting up its API-token header auth, attaching it to every call against api.localizely.com, and handling retries yourself across file upload and download. Through Jentic you install once, import the Localizely API from the API Directory, store the token once, and your agent calls it.

Permission scoping

Localizely puts the project id in the URL path (/v1/projects/{project_id}/...), so a rule can pin your agent to one project: it can download files and check translation status there and nothing else. You choose the operations it may call, so a file upload with POST /v1/projects/{project_id}/files/upload is not included unless you add it.

Credential isolation

Your Localizely admin token is stored once, encrypted, by your own Jentic One instance and injected as the API-token header at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'download translated files' or 'check translation status', and Jentic returns the matching Localizely operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Localizely API through Jentic.

Why is there no official OpenAPI spec for Localizely API?

Localizely does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Localizely API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Localizely API use?

Localizely uses an API token sent in the X-API-Token header. The token must belong to a user with the Admin role in the project. Through Jentic, the token is stored encrypted in the vault and injected at execution time, so the raw value never enters agent context.

Can I work on translations in a feature branch instead of the main project?

Yes. POST /v1/projects/{project_id}/branches/{branch} creates a branch inside a project. Subsequent file upload and download calls scoped to that branch keep work-in-progress translations isolated until you merge them back.

What are the rate limits for the Localizely API?

Rate limits are not declared in the spec. Localizely applies plan-level limits at the account level; check your plan or contact support for the exact thresholds.

How do I check translation completion before shipping a release through Jentic?

Search Jentic for 'check translation completion status'. Jentic returns the GET /v1/projects/{project_id}/status operation. Load the schema, supply the project ID, and execute. The response is per-language completion that you can gate the deployment on.

Which file formats can I upload and download?

Localizely supports a range of localization file formats including JSON, YAML, .properties, .strings, and Android XML. The upload and download endpoints accept the file format you configured at the project level on the Localizely dashboard.

Can I limit what my agent is allowed to do with the Localizely API?

Yes. Because you run Jentic One yourself, your own rules decide which Localizely operations and credentials the agent may use. Since the project id sits in the URL path (/v1/projects/{project_id}/...), a rule can pin the agent to a single project and grant only read operations such as GET /v1/projects/{project_id}/files/download and GET /v1/projects/{project_id}/status. Write operations like POST /v1/projects/{project_id}/files/upload stay off unless you explicitly add them.

Localizely API

Name: Localizely API
Brand: Localizely API
Availability: InStock

Agent-ready OpenAPI document · curated by JenticProductivityCollaborationapiKey4 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Upload and download localization files, create branches, and check translation status against a Localizely project from CI or agent workflows.

Use for: Upload a JSON localization file to my Localizely project, Download the latest translated files for a release build, Create a feature branch in my Localizely project, Check whether all languages in this project are 100% translated

Not supported: Does not handle machine translation, key-level CRUD, or in-app translation rendering - use for project file upload, download, and translation status only.

Jentic publishes the only available OpenAPI specification for Localizely API, keeping it validated and agent-ready. Localizely is a translation management platform built around uploading and downloading localization files, with branch and project organisation. The API is intentionally narrow: it covers file upload, file download, branch creation, and translation status checks, designed to be wired into curl scripts and CI pipelines that move translation files in and out of the platform. Authentication is by per-account API token in the X-API-Token header.

Jentic One on Github View OpenAPI Document

Connect the Localizely API to your agent

Capabilities

Start building with Localizely API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Localizely API