set_a11y_variant

Upsert ONE a11y variant override for (key, language, surface) - the manual fix for a gap (a11y V1). surface ∈ aria_label | alt_text | screen_reader | plain_language. The value is a TEXT string (the semantic a11y text, e.g. the accessible name or the simplified wording), translatable later via translate_a11y_variants. Address the key by key_uuid and the language by its locale CODE - exactly the (key_uuid, surface, locale) a gap carries in a11y_report, so you can fix it without resolving any UUID. Stored as a draft (bot) override. Returns {key_uuid, surface, language_code, value, status}.

Paramètres

Nom	Type		Description
project_uuid	string	optionnel	Project UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
key_uuid	string	requis	Key UUID (from list_keys or a11y_report / list_a11y_gaps items).
language_code	string	requis	Target locale CODE, e.g. 'fr' (the locale field of an a11y_report item). The backend resolves it to the language; 404 if unknown.
surface	string	requis	Which a11y surface to set. (aria_label, alt_text, screen_reader, plain_language)
value	string	requis	The a11y text value for this (key, language, surface).

Exemple

{
  "tool": "set_a11y_variant",
  "arguments": {
    "key_uuid": "<key_uuid>",
    "language_code": "<language_code>",
    "surface": "aria_label",
    "value": "<value>"
  }
}