Open Inventory / Docs
EndpointsContent translationsResourcesIdTranslationsLanguagecode

Edit, approve, or unlock translated fields

The API runs on your application instance. Schemas and field names come directly from the OpenAPI specification. Session-authenticated requests require a session on that instance.

PATCH
/resources/{id}/translations/{languageCode}

Requires write scope and the current locale-document revision. Human edits are protected from AI overwrite; accepting a suggestion keeps the field human-managed.

Authorization

bearerAuth
headerAuthorizationBearer <inv_ token>

Path Parameters

id*string
Formatuuid
languageCode*string
Lengthlength <= 35

Header Parameters

X-Organization-ID?string

Organization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.

Formatuuid

Request Body

application/json
  1. body
expectedRevision*integer
Range0 <= value
operations*array<>
Items1 <= items <= 100

Response Body

Translation document updated

Example Request
curl -X PATCH 'https://inventory.example.com/api/v1/resources/497f6eca-6276-4993-bfeb-53cbbbba6f08/translations/string' \  -H 'Content-Type: application/json' \  -d '{  "expectedRevision": 0,  "operations": [    {      "action": "set",      "fieldKey": "string"    }  ]}'
Example Response
Empty

Queue stale fields for background translation POST

Requires ai scope. Omit languageCodes to queue every active target language. Jobs are coalesced per resource and locale and survive restarts.

Queue a durable translation backfill POST

Requires an administrator browser session. All selected resource-locale jobs are persisted before the response; processing continues in the background.