Translate
Package translate is text in, the same text out in the language you asked for.
Package translate is text in, the same text out in the language you asked for.
| Base URL | https://api.hanzo.ai |
| Operations | 3 |
| Auth | Authorization: Bearer $HANZO_API_KEY |
translate
List returns the org's own translation-memory entries, newest first, optionally narrowed to one target language and/or one position on the review ladder.
GET /v1/translate/memory
List returns the org's own translation-memory entries, newest first, optionally narrowed to one target language and/or one position on the review ladder. It is the review lane's read: what a human reviewer works through.
The org is ALWAYS the validated principal's org, never a request field, so one tenant can never read another's memory — the entries hold customer source text.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
target | query | string | — | Target narrows to one target language tag (BCP-47, e.g. |
state | query | string | — | State narrows to one position on the review ladder: machine, suggested, approved or published. |
limit | query | integer | — | Limit caps the rows returned. |
Review records a human decision on one translation-memory entry, and returns the entry as stored.
PUT /v1/translate/memory
Review records a human decision on one translation-memory entry, and returns the entry as stored. A human write always wins over the stored value, and once it lands at approved or published no machine write can move it again — which is what makes a locale rebuild safe to run against reviewed work.
The org is ALWAYS the validated principal's org, never a request field, so a review can only ever land in the caller's own memory.
Request body — application/json (required)
| Field | Type | Required | Description |
|---|---|---|---|
glossary | object | — | Glossary is the terminology the entry was translated under. |
source | string | — | Source is the ORIGINAL string this entry translates. |
state | string | — | State is the entry's new position on the review ladder: suggested, approved or published. |
target | string | — | Target is the target language tag (BCP-47, e.g. |
text | string | — | Text is the reviewed translation to store. |
tier | string | — | Tier is the engine tier the entry belongs to, quality (the default) or bulk. |
post_v1_translate
POST /v1/translate
How is this guide?