Webhook events

Agent runs are asynchronous — they may take seconds, minutes, or hours depending on the work the agent performs. Subscribe to agent webhook events to receive real-time updates about run lifecycle changes instead of polling the Run endpoint.

Configure webhooks to receive notifications when agent runs are created, completed, or interrupted. These events use the same delivery pipeline as Middesk’s other webhook events: identical retry behavior, authentication options, and 2xx success contract. See Implement webhooks for setup details and Secure webhooks for signature verification.

When a run interrupts, your endpoint receives the agent’s open question and proposed artifacts so you can take action before the run resumes.

Run events

Sample payloads

1
{
2
  "object": "event",
3
  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
4
  "type": "run.created",
5
  "data": {
6
    "object": {
7
      "object": "run",
8
      "id": "c1d2e3f4-5678-90ab-cdef-1234567890ab",
9
      "created_at": "2026-01-15T12:00:00.000Z",
10
      "updated_at": "2026-01-15T12:00:00.000Z",
11
      "status": "running",
12
      "started_at": "2026-01-15T12:00:01.000Z",
13
      "ended_at": null,
14
      "steps": [],
15
      "interrupts": []
16
    }
17
  },
18
  "created_at": "2026-01-15T12:00:01.000Z"
19
}