Agent Triggers

Change trigger settings

Change some of a trigger's settings in one update, keeping the rest. allowedChannelIds applies only to Slack triggers and schedule only to cron triggers.

patch/api/agents/{agentId}/trigger/{triggerId}

Request

  • Base URL
    https://app.cotool.ai
  • Auth
    HTTP bearer

Path parameters

agentIdstring uuid required

Unique identifier of the agent

triggerIdstring uuid required

Unique identifier of the trigger

Request body

namestring
descriptionstring
allowedChannelIdsstring[]

Slack triggers only: replaces the channels it answers in

schedulestring

Cron triggers only: a cron expression

enabledboolean
eventMode'direct' | 'alert_source'

Whether an inbound event runs the configured agent directly or creates a Cotool alert before routing to the agent.

alertCreatedNotificationDestinationIdsstring[]

Slack destinations to post to when the trigger creates an alert; empty turns it off

Response

Successful response

successboolean required

Changes

No recorded changes to this operation across all 2 revisions of this API.