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

# Aient webhooks overview

> Aient delivers tenant-selectable events as CloudEvents 1.0 structured JSON with at-least-once delivery and idempotency through source and id tuples.

# Webhooks

Aient webhooks deliver tenant-selectable events as CloudEvents 1.0 structured JSON. Each event page includes the immutable schema URL, topic, source template, subject template, payload fields, and an example CloudEvent.

## Delivery semantics

| Contract      | Behavior                                                                          |
| ------------- | --------------------------------------------------------------------------------- |
| Encoding      | CloudEvents 1.0 structured JSON                                                   |
| Delivery      | At least once                                                                     |
| Ordering      | Not globally ordered; use event timestamps and IDs                                |
| Idempotency   | Use the CloudEvents (`source`, `id`) tuple as the event identity                  |
| Compatibility | Additive schema changes are preferred; removed fields require a new event version |

Validate `type`, verify signatures, process idempotently, and return a 2xx response only after durable acceptance.