Skip to content

list_surfaces

List the project's configurable SURFACES (task 928): the device and a11y surfaces variants can be authored for. Returns {surfaces:[{slug, label, kind, builtin, active}]} where kind is 'device' or 'a11y'. An un-customized project lazily defaults to the builtins - device: desktop/mobile/tablet; a11y: aria_label/alt_text/screen_reader/plain_language - all active. Only ACTIVE surfaces accept variant writes and get published to the CDN.

NameTypeDescription
project_uuidstringoptionalProject UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
{
"tool": "list_surfaces",
"arguments": {}
}