create_surface
Create a CUSTOM DEVICE surface for the project (task 928), e.g. 'watch', 'tv', 'kiosk'. Device surfaces are extensible; a11y surfaces are a FIXED semantic set - creating an a11y slug (e.g. aria_label) is rejected with 422. Returns the updated surface catalog. Builtins need no creation (they exist lazily).
Parameters
Section titled “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. |
slug | string | required | Surface slug: lowercase letters, digits, '_' or '-', 1-40 chars (e.g. 'watch'). |
label | string | optional | Optional human-readable label (defaults from the slug). |
Example
Section titled “Example”{ "tool": "create_surface", "arguments": { "slug": "<slug>" }}