---
title: Events overview
description: Understand the OrbitRail Events ingestion, authentication, retry, and retention contract.
url: https://pr-3-f831df687d6c.thally.app/events/overview
---

# Events overview

Understand the OrbitRail Events ingestion, authentication, retry, and retention contract.

OrbitRail Events accepts product events, delivers them to registered
destinations, and retries transient failures without asking your application to
operate a queue.

## Endpoint

Publish an event with `POST /v1/events`. Authenticate every request with the
`X-OrbitRail-Key` header. The API returns `202 Accepted` after it validates and
stores the payload for delivery.

## Delivery guarantees

| Behavior                     | Baseline          |
| ---------------------------- | ----------------- |
| Delivery attempt timeout     | 10 seconds        |
| Failed-delivery retry window | 72 hours          |
| Event replay retention       | 7 days            |
| Authentication header        | `X-OrbitRail-Key` |

Each delivery attempt times out after **10 seconds**. If the destination does
not respond within that window, OrbitRail treats the attempt as failed and
schedules a retry. Automatic retries continue for up to **72 hours** after the
first attempt. You can replay the retained event manually while it remains
within the seven-day retention period.