Actions & workflow control

Actions are the steps an interface runs when called. Each action does one thing — fetch data or transform it — and actions can be ordered, retried, and run conditionally on each other's results.

An action's data comes from an input: selector (request data or a previous action's output), or from a fetch: http, database, command, email, or a lookup to fan out over an array. Then validate with assert, reshape with post_transforms, and order with run_when_succeeded / run_when_failed / depends_on.

actions:
  - name: FetchUser
    http:
      url: https://api.example.com/users/a|params::id|
  - name: Notify
    run_when_succeeded: [FetchUser]
    http:
      url: https://hooks.example.com/notify
      body: { email: a|FetchUser::email| }

Reference a previous action's output with a|ActionName::field| — see Interpolation. All action fields follow.

Action

Field	Type	Description
timeout	any	Maximum execution time for this action in milliseconds.
input	string (nullable)	Specify the input source for the action. Common sources: - a|body| - HTTP request body - a|params| - URL parameters - a|action_name::field| - Output from a previous action
input_fallbacks	Array<string> (nullable)	Alternative input sources to try if the primary input is not available.
conditional_input	ConditionalInput (nullable)	Define conditional input based on runtime conditions. Uses Simple (list of input strings) or Complex (with tests).
pre_log	Array<LogMessage> (nullable)	Log messages before action execution.
post_log	Array<LogMessage> (nullable)	Log messages after successful action completion.
error_log	Array<LogMessage> (nullable)	Log messages when action fails.
success_log	Array<LogMessage> (nullable)	Log messages when action succeeds.
retry_log	Array<LogMessage> (nullable)	Log messages when action retry is attempted.
retry	Retry (nullable)	Configure automatic retry behavior.
lookup	string (nullable)	Name of a lookup configuration to use for pre-fetching data.
item_timeout	any	Per-item execution timeout for lookup iterations. Controls how long each individual item in the lookup array is allowed to run. Use timeout to cap the total loop duration.
lookup_concurrency	number (nullable)	Maximum number of lookup items to execute concurrently. Defaults to 10. Capped at 50 in managed run modes.
lookup_partition	boolean (nullable)	Separate per-item successes from failures in the lookup output. When true, the action returns `{ "succeeded": [...item data...], "failed": [{ item, http_code?, error?, data? }]…
lookup_inherit_jq	Map<string, string> (nullable)	JQ transformations to apply to lookup results.
lookup_inherit	Map<string, string> (nullable)	Fields to inherit from lookup results.
actions	Array<Action> (nullable)	Nested actions for lookup.
json_output	any	Capture specific JSON values from output.
command	CommandRun (nullable)	Execute a system command.
output_stdout	boolean (nullable)	Include command stdout in output.
http	HttpRequest (nullable)	HTTP request configuration.
database	string (nullable)	Database name for SQL operations.
google	Google (nullable)	Google API integration.
aws	Aws (nullable)	AWS service integration.
state	StateAction (nullable)	Persistent state operation (durable key/value): polling cursors, dedupe sets, idempotency keys, counters. Backed by a pluggable backend (in-memory for local single-node,…
delay	any	Pause for a fixed duration before continuing — pacing / throttling between steps. Accepts a duration string ("2s", "500ms", "1m") or a number of milliseconds. Bounded by…
email	Email (nullable)	Email sending action.
emit_metric	EmitMetric (nullable)	Emit a Prometheus metric as part of this action step. Requires expose_metrics: true on the parent config.
action	string (nullable)	Action identifier for referencing outputs.
depends_on	RunCondition (nullable)	Run this action when specified actions complete. Can be a list of action names or a RunCondition config.
run_when_succeeded	RunCondition (nullable)	Run this action when specified actions succeed.
run_when_failed	RunCondition (nullable)	Run this action when specified actions fail.
run_on_assertion	Assert (nullable)	Run this action based on assertion results.
params	Array<any> (nullable)	Parameters for SQL queries.
post_transforms	Array<Transform> (nullable)	Transformations to apply to action output.
name	string (nullable)	Action identifier/name.
description	string (nullable)	Description of the action.
query	string (nullable)	SQL query for database actions.
multi	boolean (nullable)	Run this action's query as a multi-statement batch (Postgres only). The native driver prepares every query, and a prepared statement can hold only one command — so a query…
url	string (nullable)	URL for HTTP actions.
conn_string	string (nullable)	Database connection string override.
output	string (nullable)	Output destination handler.
assert	Assert (nullable)	Validation and response configuration.
document_operation	DocumentOperation (nullable)	Document database operations.
hide_action	boolean (nullable)	Hide entire action data.
hide_data_on_success	boolean (nullable)	Hide action data on success.
hide_data_on_error	boolean (nullable)	Hide action data on error.
hide_data_on_empty	boolean (nullable)	Hide action data when empty.
hide_errors	boolean (nullable)	Hide error details.
hide_metrics	boolean (nullable)	Disable metrics collection.
response_on_success	ActionResponse (nullable)	Custom response on success.
response_on_error	ActionResponse (nullable)	Custom response on error.

ActionResponse

Field	Type	Description
http_code	number (nullable)
headers	object (nullable)
body	string (nullable)

Retry

Field	Type	Description
attempts	number	Required.
delay	number (nullable)
exponential_backoff	boolean (nullable)

LogMessage

Field	Type	Description
msg	string	Required.
level	string	Required.
json	boolean (nullable)

RunCondition

One of:

• Array<string>
• RunOnConfig

RunOnConfig

Field	Type	Description
at_least	number (nullable)
actions	Array<string>	Required.
http_code_on_error	number (nullable)

ConditionalInput

One of:

• Array<string>
• Array<ConditionalInputConfig>

ConditionalInputConfig

Field	Type	Description
input	string	Required.
tests	Array<Test>	Required.