A trigger is only evaluated on the phase where it was created; it is not automatically reapplied on other phases.
The API accepts creating two or more triggers of the same type on the same phase without returning an error. When more than one trigger of the same type fires for the same event, the outcome is non-deterministic — in the case of set-labels, for example, the last write wins. Before creating a new trigger, we recommend always listing the existing triggers on the phase (GET /v1/triggers/phases/{phaseId}) and updating the existing one instead of creating a duplicate.
Moving a card directly through the API, outside the interface, does not automatically fire the move-card triggers configured on the destination phase. That firing only happens when the card is moved through the interface, or by a chained automation (a move-card action run by another trigger).
Updating (PUT) fully replaces the trigger's actions — actions not included in the payload cease to exist after the update. We recommend always resending the complete list of actions, including the ones that did not change.
We recommend creating triggers last when setting up a flow, after phases, fields, engines, opinions, and approval workflows are already configured, since conditions typically reference those resources.
The expected format for target varies by trigger type: in save-phase-fields, selection fields (SELECT, RADIO, CHECKLIST) should use condition:"in" with target as an array, even for single-choice fields; in save-opinion and save-approval, the value is usually a plain string (for example, target:"approved").
The unary operators is-empty and is-not-empty use a hyphen, not an underscore — the underscored form is rejected. We recommend sending target explicitly in those cases (for example, an empty array) instead of omitting the key.
Deleting a trigger is not reversible through the API. Before deleting, it is worth checking whether any automation in the flow depends on it — especially move-card actions responsible for automatically advancing cards between phases.
