Subscribe to webhooks to be notified when sessions change state or goals complete.
Webhooks let your server receive real-time notifications from AgentSky — no polling needed. Register a URL and AgentSky will POST events to it as they happen.
How to register a webhook:
POST /api/v1/webhookswith your endpoint URL and the event types you want to receive.- AgentSky will POST to your URL when matching events occur.
- Respond with a 2xx status code to acknowledge each event.
Available events:
| Event | When it fires |
|---|---|
goal.completed | The agent finished its goal |
goal.stopped | The goal was stopped manually |
goal.paused | The goal is waiting for input |
goal.resumed | The goal resumed after a pause |
turn.completed | A single turn (message + response) finished |
Verifying webhook signatures:
AgentSky signs each webhook request with a signature header. Always verify this signature before acting on the payload — it confirms the request came from AgentSky.
Where: API
Good to know: Your endpoint must respond within a few seconds or the delivery will be retried. Related: Use the AgentSky API, Automate goals and routines via the API.