Sign in
v1
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/workspaces/{workspace}/triggers/{trigger_id}

Path parameters

trigger_idstring uuid required
workspacestring required

Slug of the workspace the request acts in

Slug of the workspace the request acts in

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
validation_rulesobject nullable
webhook_configobject nullable
webhook_idstring nullable
webhook_typestring nullable

Changes

Changed in 1 of the 45 revisions of this API.1