Reset a translation to its default
/branding/translations/{id}/actions/resetWrites the packaged text, and the packaged modifier when it has one (otherwise the stored modifier stays), into the translation with this key and returns it. Tenant-wide, so it needs super admin (else 403 missing_permission); a service identity cannot. A key with no packaged default or no stored row is 404 and nothing is created. dry_run shows the result without saving it. Emits branding_translation.reset only when something changed; no email. Undo it with PUT /branding/translations/{id}.
Path parameters
The translation's key, such as
deal. Translations are keyed by their text key, not a UUID, and the key is at most 255 characters.
Query parameters
Validate and run the call without committing it, returning what the real call would return with
meta.dry_runset.
Headers
Makes a retry safe. Send a new UUID for each new request and reuse it only to retry that request; the first response is replayed for 24 hours.
Responses
The translation after the reset. entrepreneur resets to "entrepreneur", not the "third party provider" the platform ships stored.
{
"data": {
"id": "string",
"key": "string",
"group": "string",
"text": {
"en": "string"
},
"modifier": "string",
"created_at": "2026-06-12T10:00:00+00:00",
"updated_at": "2026-06-12T10:00:00+00:00"
}
}Authorization failed. error.code is one of org_disabled,
ip_blocked, missing_scope, scope_disabled, user_disabled.
The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per
problem, or a code documented on the operation.
Examples
curl -X POST https://your-org-domain/kong/core/api/v2/branding/translations/{id}/actions/reset\
-H "Authorization: Bearer $HELM_API_KEY"\
-H "Content-Type: application/json"