Tolgee Octri Demo
PUT/v2/projects/{projectId}/translations/label

Add a label to a translation

Adds a label to a translation selected by its key and language within a project. Supply keyId, labelId, and languageId to identify the translation and label. The response contains the label details.

1 parameter · 3 body fields
projectIdintegerrequired
The unique identifier of the project containing the translation.

The key, label, and language identifiers for the translation to label. All fields are required.

keyIdintegerrequired
The unique identifier of the localization key.
labelIdintegerrequired
The unique identifier of the label to add.
languageIdintegerrequired
The unique identifier of the language for the translation.

5 status codes
200Returns the label details, including its identifier, name, color, and description when present.
colorstringrequired
descriptionstringoptional
idintegerrequired
namestringrequired
400Returned when the request body is invalid or a required field is missing.
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 you do not have permission to label the translation.
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 project, key, language, or label 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 body is invalid. A 401 is returned when authentication is missing or invalid, a 403 when you lack permission, and a 404 when a referenced resource cannot be found. The projectId path parameter must identify the project, and keyId, labelId, and languageId are all required.