Skip to main content

Create trigger

POST 

/api/artifacts/v1/triggers/

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 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.

Request

Responses