Triggers

Update a trigger

Updates an existing trigger's configuration. The type is immutable. Changing target_type or target_id re-checks the target-start action (orchestrations:StartRun, agents:CreateAgentGeneration or tools:CallTool) against the resulting target, because a firing runs with the trigger creator's authority rather than the updater's. A caller who could not start the new target is answered 403 and the trigger keeps the target it had.

patch/v1/projects/{project_id}/triggers/{trigger_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/triggers/{trigger_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

trigger_idstring required

Request body

namestring
descriptionstring nullable
target_type'orchestration' | 'agent' | 'tool' | 'eval'
target_idstring
actionstring nullable
inputobject nullable
tool_contextobject nullable

Replaces the stored bag; null clears it. Write-only and resolved at fire time — see CreateTriggerRequest.tool_context.

cronstring nullable
event_patternstring nullable
activeboolean
policy_idstring nullable

Response

Trigger updated

idstring
project_idstring
namestring
descriptionstring nullable
type'manual' | 'webhook' | 'schedule' | 'event'
target_type'orchestration' | 'agent' | 'tool' | 'eval'
target_idstring

Public ID of the target resource (orchestration, agent, tool, or eval)

actionstring nullable

Tool targets only — the action for mcp tools

inputobject nullable

Static input, shallow-merged under fire-time input. For eval targets the effective input may carry agent_version and baseline_run_id, which are passed to the queued run.

cronstring nullable

5-field cron expression (UTC). Present only for schedule triggers

event_patternstring nullable

Internal-event subscription pattern. Present only for event triggers: *, prefix.*, or an exact event name

activeboolean
policy_idstring nullable

Optional boundary policy that further restricts firings

next_fire_atstring date-time nullable

Read-only, schedule triggers only. Server-computed next fire time

created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.