Skip to content

Query Widget Node

UI/Container

Calls a typed query or mutation on a package widget instance. Connect Element Ref from Instantiate Widget, or Element from Get Element for a widget placed in the visual builder, then select a contract operation.

a2ui_widget_querystdLong running
Inputs3
Outputs2
Security exposure8/10
Packagestd

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.
8/10High
PrivacyPotential sensitivity of processed data.
8/10High
PerformanceRuntime or resource pressure.
7/10High
GovernancePolicy, audit, or compliance impact.
7/10High
ReliabilityOperational stability considerations.
6/10Medium
CostExternal or compute cost impact.
9/10High

Input Pins

3

▶

Execution
exec_in

Execution input

Element Ref

Struct
element_ref

Package widget reference from Instantiate Widget, or a visual-builder widget from Get Element

ElementRefElementRef5 fields
idstringrequired

Identifier of the element or widget instance.

instanceIdstring | null

Instance the element lives in. Absent for elements addressed directly.

widgetIdstring | null

Widget this instance was created from.

surfaceIdstring | null

Surface the element is rendered on.

componentvalue

The component itself, whose props are defined by the component type.

Query

String
query

Contract query to run on the widget instance

Output Pins

2

▶

Execution
exec_out

Execution output

Value

Generic
value

The query result, typed by the contract's result schema

Node Info

Internal name
a2ui_widget_query
Category
UI/Container
Version
1