latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-158263541004.1 KB

a7f071808448

nats_trigger

create nats trigger

post/w/{workspace}/nats_triggers/create

Path parameters

workspacestring required

Request body

pathstring required

The unique Windmill path for this trigger. Must be of the form u/<user>/<path> or f/<folder>/<path>. This is the trigger object path, not the HTTP route path.

script_pathstring required

Path to the script or flow to execute when a message is received

is_flowboolean required

True if script_path points to a flow, false if it points to a script

nats_resource_pathstring required

Path to the NATS resource containing connection configuration

use_jetstreamboolean required

If true, uses NATS JetStream for durable message delivery

stream_namestring nullable

JetStream stream name (required when use_jetstream is true)

consumer_namestring nullable

JetStream consumer name (required when use_jetstream is true)

subjectsstring[] required

Array of NATS subjects to subscribe to

mode'enabled' | 'disabled' | 'suspended'

job trigger mode

error_handler_pathstring

Path to a script or flow to run when the triggered job fails

error_handler_argsScriptArgs

The arguments to pass to the script or flow

retryRetry — unresolved $ref
permissioned_asstring

The user or group this trigger runs as. Used during deployment to preserve the original trigger owner.

preserve_permissioned_asboolean

When true and the caller is a member of the 'wm_deployers' group, preserves the original permissioned_as value instead of overwriting it.

labelsstring[]

Response

nats trigger created