Webhooks

Outbound webhooks notify your systems when agent sessions change state: trigger CI when a session opens a pull request, post updates to an internal dashboard, or kick off downstream automation the moment work finishes. Webhooks are in a gated preview; access is enabled per account on request.

Subscribing

There is no self-serve registration yet. Open the Webhooks page in the dashboard and request access; Ellipsis enables webhooks for your account.

Until your account is enabled, two supported ways to react to session events today:

• Poll GET /v1/sessions and act on status changes. A session's status tells you when it finished.
• Hold the session stream for a running session and react to frames as they arrive.

Both cover the common webhook jobs (run something when a session finishes, mirror progress into your own tools) without waiting for access.

Payloads

The planned events track the agent session lifecycle: a session created, updated, and finished. Event names and payload schemas are not final and are not published yet. This section will list every event with an annotated example payload when the preview opens.

Verification

Deliveries will carry a signature so you can confirm Ellipsis sent them. The signature scheme is published with the payload schemas when the preview opens.