Skip to content

translate_a11y_variants

Translate EXISTING source-language a11y overrides into target locales (task 990). Only translates (key, surface) that HAVE a source override, into the requested languages that lack one. BILLS CREDITS (standard=1, premium=4 per item, debit upfront + refund undelivered) - call a11y_estimate (mode=translate) first. Results are draft (bot-authored) overrides that flow to the CDN a11y overlays. Returns {translated, requested, credits_charged, credits_refunded}.

NameTypeDescription
project_uuidstringoptionalProject UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
tierstringoptionalQuality tier (credit_cost per unit: standard=1, premium=4). (standard, premium)
language_codesarrayrequiredTarget locales to translate into, e.g. ['fr','es'].
surfacesarrayoptionala11y surfaces to translate. Omit/empty = all four.
key_uuidsarrayoptionalRestrict to these keys (get key_uuid from list_keys). Omit to scope the whole project (or a namespace).
namespace_uuidstringoptionalRestrict to one namespace by its UUID.
idempotency_keystringoptionalStable token making this billable call safe to retry: reuse the SAME value to avoid a double-charge on retry. A random one is generated if omitted (so a blind retry would re-bill).
{
"tool": "translate_a11y_variants",
"arguments": {
"language_codes": []
}
}