Tolgee Octri Demo
PUT/v2/projects/{projectId}/tag-complex

Execute a complex tag operation

Updates tags on project keys by applying inclusion and exclusion filters. Use filterKeys and filterTag to select keys, then specify tags to add or remove from matching and non-matching keys. Tag filters support wildcards such as draft-*.

2 parameters · 8 body fields
projectIdintegerrequired
The int64 identifier of the project whose keys will be updated.
branchstringoptional
Branch name to apply the tag operation to.

Filters that select project keys and tags to add or remove from matching and non-matching keys.

filterKeysarray<object>optional
Include keys filtered by the provided key information
filterKeysNotarray<object>optional
Exclude keys filtered by the provided key information
filterTagarray<string>optional
Include keys filtered by the provided tag information. This filter supports wildcards. For example, `draft-*` will match all tags starting with `draft-`.
filterTagNotarray<string>optional
Exclude keys filtered by the provided tag information. This filter supports wildcards. For example, `draft-*` will match all tags starting with `draft-`.
tagFilteredarray<string>optional
Specified tags will be added to filtered keys
tagOtherarray<string>optional
Specified tags will be added to keys not filtered by any of the specified filters.
untagFilteredarray<string>optional
Specified tags will be removed from filtered keys. It supports wildcards. For example, `draft-*` will remove all tags starting with `draft-`.
untagOtherarray<string>optional
Specified tags will be removed from keys not filtered by any of the specified filters. It supports wildcards. For example, `draft-*` will remove all tags starting with `draft-`.

5 status codes
200Confirms that the complex tag operation completed.
400Returned when the request is invalid.
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 not authenticated.
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 is not permitted to perform the operation.
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 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 indicates missing or invalid authentication, and a 403 indicates access is denied. A 404 is returned when the project cannot be found. The projectId path parameter must identify the project whose keys you want to change.