{% action %}

Attributes

Parameter	Type	Required	Description
name	string	✓	Kebab-case action name (e.g., 'create-user')

Valid Children

Tag	Multiplicity
{% property %}	[*]
{% explanation %}	[*]

Valid Parent Contexts

This tag is valid inside: {% api %}

Rules

Rule	Force	Realm	Reference	Description
action-names-kebab-case	must	global	—	Action names use plain kebab-case — no type prefix. conventionnaming
action-vs-operation	must	global	—	Use for fire-and-forget operations. Use when a typed return value is needed. convention

Defines a fire-and-forget operation with a named input payload. Actions have no typed success response — use \{% operation %\} when you need a typed return value.

Action with property children defining the payload

tagactionproperty action-tag-with-properties

{% action name="add-bookmark" %}
Saves a new bookmark to the user's library.

{% property name="url" type="string" required=true /%}
{% property name="title" type="string" required=false /%}
{% /action %}