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

# Ingestion

> Upload and manage historical data ingestion jobs with olira ingest.

## `olira ingest`

Upload and manage historical data ingestion jobs. Requires the `sdk:historical-ingest`
scope (or an active Console session). See the
[historical backfill guide](/send-data/historical-backfill) for the full workflow.

Subcommands: `upload`, `list`, `status`, `confirm`, `cancel`, `retry-backfill`.

| Subcommand / flag         | Description                                                                                |
| ------------------------- | ------------------------------------------------------------------------------------------ |
| `upload <file>`           | Upload JSONL and create a job (pauses at review unless `--no-confirm`)                     |
| `list`                    | List ingestion jobs (`--page`, `--page-size`, `--status`)                                  |
| `status <job_id>`         | Job detail; `--watch` to tail progress                                                     |
| `confirm <job_id>`        | Confirm at `AWAITING_CONFIRMATION`; optional `--summary-types`, `--no-backfill`, `--watch` |
| `cancel <job_id>`         | Cancel a job; `--yes` to skip prompt                                                       |
| `retry-backfill <job_id>` | Retry view backfill on `COMPLETED_WITH_ERRORS` jobs                                        |