Syntax and options for `uip or triggers`, which manages time, queue, and API triggers in Orchestrator.

Manage Orchestrator triggers: time (schedule), queue, and API. All trigger types are folder-scoped. Every verb except history accepts --type <time|queue|api> (default time).

For the cross-resource conventions (auth, folder scoping, key types, output envelope), see the uip or overview.

List triggers of one type in a folder. Requires --folder-path or --folder-key. Filters: -n, --name (contains-match), --enabled, --disabled (mutually exclusive). Paginated via -l, --limit (default 50) / --offset. --sort-by <field> sorts results (default Id desc). --all-fields returns the full API response instead of the curated subset.

Get a trigger by key. Requires --folder-path or --folder-key. --all-fields returns the full API response instead of the curated subset.

Create a trigger. Required flags: --name, --release-key, --runtime-type <Serverless|Unattended|Headless|NonProduction|AgentService>. --job-priority <Low|Normal|High> defaults to Normal. Pass --disabled to create the trigger in a disabled state (default: enabled).

The folder is inferred from --release-key. Pass --folder-path or --folder-key when your identity has a folder-level role only (such as an external app), because such an identity cannot look processes up tenant-wide.

Type-specific:

Common: -d, --description, --input-arguments <json>, --calendar-key, --stop-strategy <SoftStop|Kill>, --kill-process-expression, --resume-on-same-context, --run-as-me, repeatable --target "machine=<guid>,user=<guid>,session=<int>", --mapping-mode <dynamic|strict> (default dynamic; use strict when the folder has "Enable account-machine mappings" turned on).

Update by key. Requires --folder-path or --folder-key. Only the fields you provide change. Accepts --name, --release-key, --runtime-type, --job-priority, --target, --mapping-mode, and the type-specific flags of create, all optional. -d, --description, --input-arguments, --calendar-key, --stop-strategy, and --kill-process-expression are create-only. Use --no-* counterparts to unset booleans (for example --no-activate-on-complete, --no-resume-on-same-context, --no-run-as-me). Pass --enabled or --disabled to toggle the trigger's state (mutually exclusive).

Delete a trigger by key. Requires --folder-path or --folder-key, and -y, --yes — the CLI never prompts for destructive operations.

Show the failed fire attempts of a trigger (fire log): why the trigger failed to fire, for example a missing license, no machines, or a disabled trigger. Works for time, queue, API, and Integration Service event triggers; the trigger type is detected from the key, so history takes no --type flag. Requires --folder-path or --folder-key. Paginated via -l, --limit (default 50) / --offset. --sort-by <field> sorts results (default TimeStamp desc). --all-fields returns the full API response instead of the curated subset.

An empty Data array means the trigger has no recorded fire failures, not that it never ran. Use uip or jobs list to see the jobs a trigger started.

If the key does not match a trigger in the folder, the command fails with ErrorCode: "not_found" and exits 1.

Refer to Exit codes for the shared contract. delete exits 1 if -y, --yes is omitted. Every verb that requires a folder exits 1 when neither --folder-path nor --folder-key is provided. history exits 1 with ErrorCode: "not_found" when the key does not match a trigger.