---
title: Events overview
description: Understand the OrbitRail Events ingestion, authentication, retry, and retention contract.
url: https://pr-5-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          |
| ---------------------------- | ----------------- |
| Failed-delivery retry window | 72 hours          |
| Event replay retention       | 7 days            |
| Authentication header        | `X-OrbitRail-Key` |

OrbitRail stops automatic delivery attempts after 72 hours. You can replay the
retained event manually with `POST /v1/events/{eventId}/replay` while it
remains within the seven-day retention period. The replay endpoint returns
`202 Accepted` when the event is queued for a new delivery attempt, or
`404 Not Found` when the event no longer exists or has passed the retention
window.