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

# run

> Run the applicable guarantees against this configuration and report (§9.1).

`ctrlrun.verify.run` — function, defined at `src/ctrlrun/verify/__init__.py:112`

```python theme={null}
def run(config: str | os.PathLike[str] | None, authority: str | os.PathLike[str] | None, only: Sequence[str], store_url: str | None) -> Report
```

Run the applicable guarantees against this configuration and report (§9.1).

Raises `VerifyRefused` where the configuration is refused or unusable (exit 2) and
`VerifyInternalError` where verify itself is at fault (exit 3). Everything else — a
guarantee that failed, a guarantee that could not be exercised — is in the `Report`.

The scratch directory is removed when the run ends, **including when it ends by
exception**. The operator's store is not opened, not read and not created (§3.5, T103).

## Next

* [Python API index](/reference/api/index).
* [Get started](/get-started/quickstart) · [Why](/why).


## Related topics

- [run](/reference/api/conformance-run.md)
- [CTRLRun](/index.md)
- [Run on Postgres](/guides/run-on-postgres.md)
- [CTRLRunError](/reference/api/CTRLRunError.md)