---
title: "Webhooks"
url: https://docs.light-ai.app/api-reference/webhooks.md
canonical_url: https://docs.light-ai.app/api-reference/webhooks
last_updated: 2026-10-13
summary: "Signed (Standard Webhooks) event delivery with retries, logs and replay."
api_status: beta
related:
  - https://docs.light-ai.app/api-reference
---

# Webhooks

> Signed (Standard Webhooks) event delivery with retries, logs and replay.

Signed (Standard Webhooks) event delivery with retries, logs and replay. Delivery is at-least-once: the same event can arrive more than once (a retry after a timeout, a replay), always with the same webhook-id, so de-duplicate on webhook-id. Order is not guaranteed: a retried event can arrive after a later one, so compare data.object.updated_at (and data.stage_change.sequence for project.stage_changed) with what you stored and skip older ones. data.object is the object as it is when the delivery is sent: upsert by its id rather than assuming an earlier event arrived first.

- `GET /v1/webhook_endpoints`: [List your webhook endpoints](https://docs.light-ai.app/api-reference/webhooks/list-webhook-endpoints.md)
- `POST /v1/webhook_endpoints`: [Subscribe a webhook endpoint](https://docs.light-ai.app/api-reference/webhooks/create-webhook-endpoint.md)
- `GET /v1/webhook_endpoints/{endpoint_id}`: [Retrieve a webhook endpoint](https://docs.light-ai.app/api-reference/webhooks/get-webhook-endpoint.md)
- `PATCH /v1/webhook_endpoints/{endpoint_id}`: [Update a webhook endpoint](https://docs.light-ai.app/api-reference/webhooks/update-webhook-endpoint.md)
- `DELETE /v1/webhook_endpoints/{endpoint_id}`: [Unsubscribe (delete) a webhook endpoint](https://docs.light-ai.app/api-reference/webhooks/delete-webhook-endpoint.md)
- `POST /v1/webhook_endpoints/{endpoint_id}/rotate_secret`: [Rotate the signing secret](https://docs.light-ai.app/api-reference/webhooks/rotate-webhook-secret.md)
- `POST /v1/webhook_endpoints/{endpoint_id}/test`: [Send a test event](https://docs.light-ai.app/api-reference/webhooks/test-webhook-endpoint.md)
- `GET /v1/webhook_endpoints/{endpoint_id}/deliveries`: [List an endpoint's deliveries](https://docs.light-ai.app/api-reference/webhooks/list-webhook-deliveries.md)
- `POST /v1/webhook_endpoints/{endpoint_id}/replay`: [Replay events to an endpoint](https://docs.light-ai.app/api-reference/webhooks/replay-webhook-deliveries.md)
- `POST /v1/webhook_deliveries/{delivery_id}/retry`: [Retry one delivery now](https://docs.light-ai.app/api-reference/webhooks/retry-webhook-delivery.md)