Skip to content

update_surface

Rename and/or toggle a surface (task 928): set its label and/or active. Deactivating is SOFT - existing variants are RETAINED but hidden and dropped from the CDN until reactivated (which republishes them); the response affected_variants reports how many are impacted. Builtins can be toggled/renamed but not deleted. Returns {surfaces, affected_variants}.

NameTypeDescription
project_uuidstringoptionalProject UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
slugstringrequiredSlug of the surface to update.
labelstringoptionalNew human-readable label (rename).
activebooleanoptionalActivate (true) or soft-deactivate (false) the surface.
{
"tool": "update_surface",
"arguments": {
"slug": "<slug>"
}
}