protected

triggers

Update Trigger

Update an existing trigger.

Updates the specified trigger with the provided data. Only non-null fields in the request will be updated. Secret selections preserve unselected credential fields; legacy raw credentials replace the stored bundle.

Args: trigger_id: The unique identifier of the trigger. payload: Trigger update DTO (single source of truth shared with MCP toolset). user_context: Authentication context. trigger_service: Injected trigger service. secret_manager: Injected secret manager for credential storage. secret_catalog: Workspace-scoped catalog for selected credential references. webhook_service: Injected service that registers the channel webhook.

Returns: The updated trigger.

Raises: HTTPException: If trigger not found or validation fails.

put/v1/triggers/{trigger_id}

Path parameters

trigger_idstring uuid required

Request body

agent_idstring uuid nullable

allowed_methodsstring[] nullable

channel_credentialsobject nullable

Channel credentials to update. Pass to rotate credentials.

conditionsobject nullable

cron_expressionstring nullable

descriptionstring nullable

enabledboolean nullable

Toggle the trigger active state. Maps to is_active server-side. REST clients may pass either enabled (canonical) or is_active (alias).

event_typesstring[] nullable

failure_thresholdinteger nullable

namestring nullable

task_parametersobject nullable

timezonestring nullable

validation_rulesobject nullable

webhook_configobject nullable

webhook_typestring nullable

Response

Successful Response

agent_idstring uuid required

allowed_methodsstring[] nullable

conditionsobject required

consecutive_failuresinteger required

created_atstring required

created_bystring required

cron_expressionstring nullable

data_extractorstring nullable

descriptionstring required

event_typesstring[]

failure_thresholdinteger required

has_channel_credentialsboolean

idstring uuid required

is_activeboolean required

last_execution_atstring nullable

namestring required

next_run_timestring nullable

task_parametersobject required

timezonestring nullable

trigger_typestring required

updated_atstring required