---
title: Events API overview
description: Use the OrbitRail Events HTTP API to publish customer events for delivery.
url: https://pr-5-f831df687d6c.thally.app/api/introduction
---

# Events API overview

Use the OrbitRail Events HTTP API to publish customer events for delivery.

The OrbitRail Events API accepts events for asynchronous delivery.

## Base URL

```text
https://events.orbitrail.example
```

## Endpoints

| Method | Path | Summary |
| ------ | ---- | ------- |
| `POST` | `/v1/events` | Publish an event for delivery |
| `POST` | `/v1/events/{eventId}/replay` | Replay a retained event |

Send `POST /v1/events` with a JSON body and your API key. A valid request returns
`202 Accepted`. Failed downstream deliveries retry for up to 72 hours.

To replay a retained event, send `POST /v1/events/{eventId}/replay`. Events
remain available for replay for 7 days from ingestion.

The OpenAPI reference in this site is generated from the reviewed
`openapi.yaml` contract in the documentation repository.