# keryn api import

Describes Keryn 0.5.2 and keryn-rules 0.8.0.

> keryn api import: author API security regressions from OpenAPI or HAR

Source: https://keryn.dev/docs/reference/cli/api-import/

> **Caution: Next release: keryn api import**
> On main; not in Keryn 0.5.2, the latest release.

Author API security regressions from OpenAPI or HAR.

```text
keryn api import <file> --format openapi|har --target <origin> --application <id> --revision <revision> --out <new-directory>
```

## Options

```text
Usage: keryn api import <file> --format openapi|har --target <origin> --application <id> --revision <revision> --out <new-directory>
       keryn api compile <review.json> --out <new-directory> [--json]
       keryn api validate <suite.json> [--json]
       keryn api run <suite.json> --out <new-directory> [--suite-sha256 <digest>] [--timeout <seconds>] [--json]
       keryn api review <receipt.json> --suite <suite.json> --baseline <receipt.json> --baseline-suite <suite.json> --out <new-directory>
Import OpenAPI 3.0/3.1 JSON/YAML or HAR locally. No references are fetched; drafts cannot execute.
Compile an explicitly authored api-suite-review/v1 into the existing AI security suite contract.
Validate and compile send no requests. Run executes reviewed requests and may change target state.
The browser API Workbench authors these reviews. Existing ai-test packs/init/verify remain available.
```

## Examples

```sh
# Draft; references are not fetched and drafts cannot execute.
keryn api import openapi.yaml --format openapi --target https://staging.example.com --application shop --revision abc123 --out out/api
```

## Exit codes

| Code | Meaning |
|---|---|
| 0 | pass |
| 1 | findings or a requested change gate |
| 2 | usage error or invalid input |
| 3 | incomplete or unknown completion |
| 4 | execution or normalization failure |
