PUT/v2/projects/{projectId}/keys/{keyId}/tags

Add a tag to a localization key

Adds a tag to a localization key, creating the tag if no tag with the supplied name exists. Supply the tag name in name to associate it with the key.

2 parameters · 1 body field
keyIdintegerrequired
The int64 identifier of the localization key to tag.
projectIdintegerrequired
The int64 identifier of the project containing the key.

The tag name to associate with the localization key.

namestringrequired
The tag name. Must not exceed 100 characters.

5 status codes
200Returns the tag object, including its identifier and name.
idintegerrequired
namestringrequired
400Returned when the request is invalid, `name` is missing, or the tag name exceeds 100 characters.
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 has no valid authentication.
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 the authenticated user does not have permission to tag the key.
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 or key 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 is returned when authentication is missing or invalid. A 403 is returned when the authenticated user lacks access. A 404 is returned when the project or key cannot be found. The keyId path parameter and projectId path parameter must identify the key and its project. name is required and must not exceed 100 characters.