Updated August 12, 2026

On this page

A2UI surface types: SurfaceSpec describes a rendered surface; CreateSurface, UpdateComponents, UpdateDataModel, and DeleteSurface are the mutating operations unioned as SurfaceOperation.

#protocols.src.orxtra.protocols._types._surfaces

#`protocols.src.orxtra.protocols._types._surfaces`

#`SurfaceSpec`

SurfaceSpec
Field	Type	Default
`surface_id`	`str`
`catalog_id`	`str`
`theme`	`dict[str, Any]	None`

#`CreateSurface`

CreateSurface
Field	Type	Default
`surface_id`	`str`
`catalog_id`	`str`
`theme`	`dict[str, Any]	None`	`None`
`send_data_model`	`bool`	`False`

#`UpdateComponents`

UpdateComponents
Field	Type	Default
`surface_id`	`str`
`components`	`list[dict[str, Any]]`

#`UpdateDataModel`

UpdateDataModel
Field	Type	Default
`surface_id`	`str`
`path`	`str`	`'/'`
`value`	`Any`	`None`

#`DeleteSurface`

DeleteSurface
Field	Type	Default
`surface_id`	`str`