Skip to content

Triggers (Planned for V3)

Cron and webhook triggers are on the V3 roadmap and not yet available in V2.

In V2, each schema has a Chat Enabled toggle (Admin Dashboard → Schemas → select schema → Settings). When enabled, the schema accepts chat requests via the REST API:

Terminal window
POST /api/v1/schemas/{schema_id}/chat

This is the primary way to initiate agent conversations — from your application, a frontend client, or any HTTP-capable service.

  • Cron triggers: schedule agents to run on a cron expression (e.g., 0 9 * * 1-5 — weekdays at 9 AM)
  • Webhook triggers: fire an agent from an external HTTP call (order created, deployment completed, alert received)
  • on_complete callbacks: notify downstream systems when a triggered task finishes

Follow the changelog for updates on trigger support.