SIsimplified
triggers

Triggers · Create a trigger

Creates a trigger — what makes an agent run on its own: a schedule, a webhook, or a chat channel.

config must match the shape the chosen kind expects. A mismatched config is accepted and produces a trigger that never fires correctly, so read the kind's expected shape first rather than guessing.

resource: agent://build-guide covers the trigger lifecycle.

post/api/v1/triggers

Request

  • Base URL
    https://kd-agents.simplified.com
  • Auth
    API key in header Authorization

Request body

agentstring

Agent UUID this trigger fires.

namestring
descriptionstring
kind'scheduled' | 'webhook' | 'event' | 'slack' | 'whatsapp'

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.

status'active' | 'paused' | 'inactive' | 'completed'
commandstring

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

deliveryobject

Where the result goes. Interpreted by the agent, not the dispatcher.

extraobject

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

Response

The created trigger.

TriggersCreateTriggerResponse201 required

Empty response body

Changes

No recorded changes to this operation across all 1 revision of this API.