update_trigger replaces configuration, rather than patching one field. Always call get_trigger first. Build a write object containing triggerId, name, prompt, requiresVm, optional executionConfigId, runNameTemplate, concurrencyLimit, model, optional effort, and the full intended events array. Preserve each existing event’s id, slug, kind, enabled, and writable config. Strip read-only response fields (triggerId inside events, timestamps, reflection, secretConfigured and destination). Do not pass the entire read response unchanged.
Triggers using exe.dev may set optional vmImage to a public Docker/OCI image reference such as ghcr.io/org/image:tag. Leaving it blank uses exe.dev’s default image. In the trigger editor, Verify image creates a temporary owned VM, checks SSH and workspace prerequisites, and deletes the VM; it never runs the trigger prompt. Verification is explicit and autosaving does not create VMs. Private images and registry credentials are not supported. Verification records what worked at that time; mutable tags may later resolve to a different image.
Supply expectedUpdatedAt from the fetched trigger’s updatedAt to protect against concurrent edits. On stale_trigger, fetch again and reapply the desired changes. Omitting it retains last-writer-wins behavior. Omitted optional configuration resets to defaults; omitted events remove the configured automatic events. Preserve all events you want to keep.
After saving, call get_trigger and compare prompt, target and events. enable_trigger and disable_trigger change enabled state without rebuilding configuration. Disabling automation does not stop an existing run. Trigger saves can event edited lifecycle subscribers. Deleting a Trigger removes its template and events. Runs and artifacts follow their normal retention period.
Names
The browser displays the owning skill name and has no separate trigger-name field or skill selector. Skill renames preserve IDs and run history. The compatibility API still accepts a trigger’s internal name in its existing shared resource namespace; use the name returned byget_trigger when updating through that interface.