Skip to navigation
AgentsTriggers

Triggers · Update a trigger

View as Markdown

Partial update. System-managed schedules are locked and reject edits with 403.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

trigger_idstringRequired

Request

This endpoint expects an object.
agentstringOptional
Agent UUID this trigger fires.
namestringOptional
descriptionstringOptional
kindenumOptional

What causes a run. scheduled requires command; the chat kinds route inbound messages and are normally created by connecting the channel in the UI rather than here.

Allowed values:
statusenumOptional
Allowed values:
commandstringOptional

The instruction sent to the agent when the trigger fires. Required for scheduled.

deliverymap from strings to anyOptional
Where the result goes. Interpreted by the agent, not the dispatcher.
extramap from strings to anyOptional

Kind-specific configuration, including the schedule itself for scheduled triggers. Read agents_listTriggerKinds for the shape.

Response

The updated trigger.

Errors

403
Forbidden Error