v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01251238661.6 KB

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. If channel_credentials are provided, they replace the existing credentials in the secret store.

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.

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

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).

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

validation_rulesobject nullable

webhook_configobject nullable

webhook_idstring nullable

webhook_typestring nullable