Tolgee Octri Demo
POST/v2/organizations/{organizationId}/translation-memories

Create a shared translation memory

Creates a shared translation memory for an organization. Supply name and sourceLanguageTag; configure the default match penalty, review-only write behavior, and project access through assignedProjects as needed. The response includes the created memory and its organization owner.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 5 body fields
organizationIdintegerrequired
The unique numeric identifier of the organization that will own the shared translation memory.

Configuration for the shared translation memory. name and sourceLanguageTag are required; other fields configure penalties, review-only writes, and project assignments.

assignedProjectsarray<object>optional
Project assignments with access settings.
defaultPenaltyintegeroptional
Default penalty (0–100) subtracted from match scores for every assignment that does not define its own override. Defaults to 0.
namestringrequired
Translation memory name
sourceLanguageTagstringrequired
Source language tag according to BCP 47 definition
writeOnlyReviewedbooleanoptional
When true, only translations whose state is REVIEWED are written to this TM. Translations that drop back to TRANSLATED or UNTRANSLATED also remove the entry. TMX import and direct TM-browser edits bypass this filter. Defaults to false.

5 status codes
200Returns the created translation memory, including its identifier, name, source language, type, default penalty, review-only write setting, and organization owner.
defaultPenaltyintegerrequired
Default penalty (0–100) subtracted from match scores for every assignment that does not define its own override.
idintegerrequired
namestringrequired
organizationOwnerobjectrequired
sourceLanguageTagstringrequired
Source language tag of the translation memory
typestringrequired
Allowed:PROJECTSHARED
writeOnlyReviewedbooleanrequired
When true, only translations in REVIEWED state contribute to this TM.
400Returned when the request is invalid or a body value fails validation.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
401Returned when the request is unauthenticated.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
403Returned when access to the organization or operation is forbidden.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
404Returned when the organization cannot be found.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional

Error handling

A 400 is returned when the request is invalid, a 401 when authentication is missing or invalid, a 403 when access is forbidden, and a 404 when the organization cannot be found. name and sourceLanguageTag are required; name must be 1–100 characters, and sourceLanguageTag must be 1–20 characters with no commas. defaultPenalty and each assignment's penalty must be between 0 and 100; each assignedProjects item must include projectId, readAccess, and writeAccess. The organizationId path parameter identifies the organization.