---
sidebar:
  label: roboto.experimental.ingestion_runs
  order: 2
title: roboto.experimental.ingestion_runs
---
The runs of an ingestion rule's trigger on a file.

A leaf module: [`roboto.experimental.sessions`](/docs/reference/python-sdk/roboto/experimental/sessions) reports runs too, and importing [`roboto.experimental.ingestion_rules`](/docs/reference/python-sdk/roboto/experimental/ingestion_rules) from there would be circular.

## Module Contents

### IngestionRun

```python
class roboto.experimental.ingestion_runs.IngestionRun(/, **data: Any)
```

`from roboto.experimental.ingestion_rules import IngestionRun`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/experimental/ingestion_runs.py#L34-L46)

Bases: `pydantic.BaseModel`

The latest time an ingestion rule's trigger ran on a file's current upload.

**Parameters**

- **data** (`Any`)

**Attributes**

- **IngestionRun.detail** (`str | None`) = `None`: Why the trigger could not start the action, when it could not.
- **IngestionRun.file_id** (`str`)
- **IngestionRun.invocation_id** (`str | None`) = `None`: The action invocation the run started. `None` when the trigger could not start one.
- **IngestionRun.rule_id** (`str`): The rule whose trigger ran.
- **IngestionRun.started** (`datetime.datetime`)
- **IngestionRun.status** (`IngestionRunStatus`)
- **IngestionRun.trigger_id** (`str`)

### IngestionRunStatus

```python
class roboto.experimental.ingestion_runs.IngestionRunStatus
```

`from roboto.experimental.ingestion_rules import IngestionRunStatus`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/experimental/ingestion_runs.py#L21-L31)

Bases: `roboto.compat.StrEnum`

Where one run of a rule's trigger on a file stands.

**Attributes**

- **IngestionRunStatus.Failed** = `'failed'`: The action failed or was cancelled, or the trigger could not start it.
- **IngestionRunStatus.Finished** = `'finished'`: The action finished. The file's `ingestion_status` says how much of it was ingested.
- **IngestionRunStatus.Running** = `'running'`: The ingestion action is queued or running.