OpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-148243531000.1 KB

5f7e0c3a8f59

http_trigger

update http trigger

post/w/{workspace}/http_triggers/update/{path}

Path parameters

workspacestring required
pathstring 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 triggered

route_pathstring

The URL route path that will trigger this endpoint (e.g., 'api/myendpoint'). Must NOT start with a /.

summarystring nullable

Short summary describing the purpose of this trigger

descriptionstring nullable

Detailed description of what this trigger does

workspaced_routeboolean

If true, the route includes the workspace ID in the path

authentication_resource_pathstring nullable

Path to the resource containing authentication configuration (for api_key, basic_http, custom_script, signature methods)

is_flowboolean required

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

http_method'get' | 'post' | 'put' | 'delete' | 'patch' required
is_asyncboolean

Deprecated, use request_type instead

request_type'sync' | 'async' | 'sync_sse'
authentication_method'none' | 'windmill' | 'api_key' | 'basic_http' | 'custom_script' | 'signature' required
is_static_websiteboolean required

If true, serves static files from S3/storage instead of running a script

wrap_bodyboolean

If true, wraps the request body in a 'body' parameter

raw_stringboolean

If true, passes the request body as a raw string instead of parsing as JSON

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

http trigger updated