> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trystratos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Register endpoints to be notified of events (delivery not yet live — see the guide).

<Warning>
  Delivery isn't implemented yet — see the [webhooks guide](/guides/webhooks) for full context.
</Warning>

## Create

`POST /v1/webhooks` — requires `webhooks:write`.

Response includes `secret` (`whsec_...`) once, at creation.

## List / delete

* `GET /v1/webhooks` — `webhooks:write`
* `DELETE /v1/webhooks/{id}` — `webhooks:write`