triggers

Manage activation triggers on agents and standalone user triggers.

---

Agent Triggers

List

GET /api/agents/:agentId/triggers

Create

POST /api/agents/:agentId/triggers
Content-Type: application/json

{
  "type": "schedule",
  "name": "Daily Morning Check",
  "configJson": { "cronExpression": "0 9 * * *", "timezone": "UTC" },
  "enabled": true
}

Update

PUT /api/triggers/:id

Delete

DELETE /api/triggers/:id

---

Standalone User Triggers

Triggers that exist at the account level, optionally linked to an agent:

GET    /api/user-triggers
POST   /api/user-triggers
PUT    /api/user-triggers/:id
DELETE /api/user-triggers/:id
POST   /api/user-triggers/:id/fire     ← manually fire

User triggers track fireCount and lastFired timestamps.

---

Config Fields

Type	Fields
schedule / cron	cronExpression, timezone
webhook	webhookPath, secretToken
event / agent_finished / agent_output	eventType, eventFilter