update_key

Edit a key in place - its SOURCE-language value, its type, and/or its description (pass at least one). Preserves the key and its history (version bump + history revision + audit). Address the key by EITHER key_uuid (preferred; from list_keys) OR namespace + name - exactly one of the two. When the source value ACTUALLY changes, the key's reviewed/approved target translations are demoted to needs-review ("translated"); missing/draft/translated targets are untouched, and stale_flagged reports how many were demoted. Submitting the current value is a no-op (result=unchanged, not billed). A real source change (or a description-only change) bills 1 unit.

Parameters

Name	Type		Description
project_uuid	string	optional	Project UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
key_uuid	string	optional	Key uuid to update (preferred addressing; get it from list_keys). Mutually exclusive with namespace+name.
namespace	string	optional	Namespace slug (use with name as an alternative to key_uuid).
name	string	optional	Dot-notation key name (use with namespace as an alternative to key_uuid).
source_value	string	optional	New source-language value to write.
description	string	optional	Optional: also update the key's description.
type	string	optional	Optional: reclassify the key's semantic type (see create_key). Changing the type re-gates which a11y treatments the key offers. (text, heading, label, caption, badge, tooltip, error_message, toast, button, link, menu_item, input_placeholder, input_label, image, icon, meta_title, meta_description)

Example

{
  "tool": "update_key",
  "arguments": {}
}