Branding

Reset a translation to its default with the old path

POST/branding/translations/{key}/reset
branding:writereset_branding_translation_deprecatedDestructiveDeprecatedSunset 2027-06-30

Behaves exactly like POST /branding/translations/{id}/actions/reset: it writes the packaged text and modifier into the translation with this key and returns it. Deprecated: it will be withdrawn on 2027-06-30. Use the actions/reset path, which the Deprecation and Sunset headers point towards. Needs super admin; a key with no packaged default or no stored row is 404. 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

  • keystringRequired#

    The translation's key, such as deal.

Query parameters

  • dry_runboolean#

    Validate and run the call without committing it, returning what the real call would return with meta.dry_run set.

Headers

  • Idempotency-Keystring#

    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

200

The translation after the reset.

Translation
{
  "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"
  }
}
401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl -X POST https://your-org-domain/kong/core/api/v2/branding/translations/{key}/reset\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"