Enable or disable an automation trigger
Consequential — writes an audit entry.
Authorizations
API key or personal access token (NEX-1042). Send as
Authorization: Bearer <token>. Token format:
nex_live_…— live API key (server-to-server)nex_test_…— sandbox API keynex_pat_…— personal access token (acts as the issuing user)
Authorization is decided by the key's scopes array, not the
owning user's RBAC role. See POST /api/api-keys to mint a key.
Body
Response
Trigger updated
An automation trigger that fires an agent on a schedule or event.
schedule, event, manual, webhook 5-field cron; required for schedule triggers.
IANA timezone for cron evaluation (defaults to UTC).
Business event name; required for event triggers (e.g. shift.ncns).
Equality filters (dot-path) the event payload must satisfy.
Identity the run acts as (drives tool scope + RBAC).
Auto-disabled after 5 consecutive schedule-dispatch failures.

