v1
protected
triggers

Execute Trigger

Execute a trigger with the provided event data.

Builds trigger data from the events and channel origin, then creates and submits a task for agent execution.

Authorization is the caller's session plus the workspace-scoped trigger lookup: a trigger in another workspace is simply not found. This used to sit on the public router behind an X-Internal-Token check that skipped itself whenever the secret was unset — which was every deployment, since nothing ever sent that header.

Args: trigger_id: The unique identifier of the trigger request: Events and channel origin data trigger_service: Injected trigger service

Returns: Execution result with task ID

Raises: HTTPException: If trigger not found or execution fails

post/v1/triggers/{trigger_id}/execute

Path parameters

trigger_idstring uuid required

Request body

channel_originobject
eventsobject[]

Response

Successful Response

object required

Changes