Orb is built for real-time event ingestion, so the API enforces a grace period on event timestamps. This ensures we're able to pre-compute queries over older usage data, making them quicker to serve (e.g. for usage graphs).

But what if you want to ingest older usage events? Some use cases we've seen include:

1. You've made a mistake in your reported events, so you want to replace the events in a time range.
2. Your usage event reporting pipeline was down for a period, so you want to fill in those events.
3. You're integrating with Orb for the first time and want to send in historical events.

You can now ingest older usage events with backfills. Backfilling usage events is now possible in 3 simple steps:

1. Create the backfill
2. Ingest events referencing that backfill
3. Close the backfill, making the updated usage data visible in Orb.

You can also revert a backfill, allowing you to undo mistakes.

Visit our docs to read about creating event backfills.