List an agent's automation triggers
Automation triggers fire an agent on a cron schedule or a business
event through the durable headless run path. Requires the
agents.manage permission and the ai suite.
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.
Path Parameters
Response
The agent's triggers
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.

