Triggers

Endpoints for managing triggers and trigger events.

📄️List triggers

Return all triggers in the specified folder.

📄️Create trigger

Creates a trigger that runs a workflow instance with the specified config in response to changes in an artifact file or folder. Provide exactly one of `file` or `folder`. If `folder` is provided, `pattern` is required. File triggers fire whenever the specified file is modified. Folder triggers fire whenever a matching file is created, modified, or deleted anywhere within the folder, recursively including all subfolders. The supplied `pattern` filters which files qualify, using [fnmatch syntax](https://docs.python.org/3/library/fnmatch.html) matched against the file name only (not the path). A `debounce` period (in seconds) suppresses rapid successive events: the first qualifying event starts a workflow run, and any further events within the debounce window are ignored. Note that artifacts created, updated, or deleted by workflows within the same project do not fire triggers, in order to prevent infinite loops.

📄️Get trigger

Return details for a single trigger by ID.

📄️Update trigger

Update an existing trigger.

📄️Delete trigger

Delete a trigger.

📄️List trigger events

List events for a given trigger ID in reverse chronological order.

📄️Play trigger

Play a trigger by enqueueing a test workflow with the trigger's workflow config.