# polymorfa bansafe

> Commands under polymorfa bansafe.

## Commands

- [polymorfa bansafe claim list](https://docs.polymorfa.com/cli/bansafe/claim-list): List BanSafe attribution claims for one project.
- [polymorfa bansafe claim view](https://docs.polymorfa.com/cli/bansafe/claim-view): View one BanSafe attribution claim.
- [polymorfa bansafe collection list](https://docs.polymorfa.com/cli/bansafe/collection-list): List BanSafe telemetry collection status for one project.
- [polymorfa bansafe enforcement list](https://docs.polymorfa.com/cli/bansafe/enforcement-list): List recorded BanSafe enforcement for one project.
- [polymorfa bansafe finding list](https://docs.polymorfa.com/cli/bansafe/finding-list): List measured BanSafe findings for one project.
- [polymorfa bansafe health history](https://docs.polymorfa.com/cli/bansafe/health-history): List recorded BanSafe Health evaluations for one session.
- [polymorfa bansafe health list](https://docs.polymorfa.com/cli/bansafe/health-list): List current BanSafe Health for one project.
- [polymorfa bansafe health view](https://docs.polymorfa.com/cli/bansafe/health-view): View current BanSafe Health for one session.
- [polymorfa bansafe health-action list](https://docs.polymorfa.com/cli/bansafe/health-action-list): List durable BanSafe Health actions for one project.
- [polymorfa bansafe health-policy update](https://docs.polymorfa.com/cli/bansafe/health-policy-update): Replace the BanSafe Health rule for one project.
- [polymorfa bansafe health-policy view](https://docs.polymorfa.com/cli/bansafe/health-policy-view): View the BanSafe Health rule for one project.
- [polymorfa bansafe incident list](https://docs.polymorfa.com/cli/bansafe/incident-list): List recorded BanSafe incidents for one project.
- [polymorfa bansafe incident report](https://docs.polymorfa.com/cli/bansafe/incident-report): Report a customer-observed BanSafe incident.
- [polymorfa bansafe incident retract](https://docs.polymorfa.com/cli/bansafe/incident-retract): Retract one customer-reported BanSafe incident.
- [polymorfa bansafe insurance-evidence update](https://docs.polymorfa.com/cli/bansafe/insurance-evidence-update): Update project insurance evidence collection.
- [polymorfa bansafe insurance-evidence view](https://docs.polymorfa.com/cli/bansafe/insurance-evidence-view): View project insurance evidence collection.
- [polymorfa bansafe safe-mode update](https://docs.polymorfa.com/cli/bansafe/safe-mode-update): Update project or session Safe Mode settings.
- [polymorfa bansafe safe-mode view](https://docs.polymorfa.com/cli/bansafe/safe-mode-view): View project or effective session Safe Mode.
- [polymorfa bansafe signal list](https://docs.polymorfa.com/cli/bansafe/signal-list): List the bounded BanSafe telemetry signal catalogue.
- [polymorfa bansafe telemetry history](https://docs.polymorfa.com/cli/bansafe/telemetry-history): List bounded BanSafe telemetry snapshots for one session.
- [polymorfa bansafe telemetry view](https://docs.polymorfa.com/cli/bansafe/telemetry-view): View the latest bounded BanSafe telemetry for one session.
- [polymorfa bansafe warmup update](https://docs.polymorfa.com/cli/bansafe/warmup-update): Update the warmup plan for one project.
- [polymorfa bansafe warmup view](https://docs.polymorfa.com/cli/bansafe/warmup-view): View the warmup plan for one project.

## polymorfa bansafe claim list

List BanSafe attribution claims for one project.

### Usage

```bash
polymorfa bansafe claim list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from an opaque page cursor.
- `--limit <value>` (value).
- `--project <value>` (value, required). Project ID.
- `--session <value>` (value). Match one session ID or name.
- `--status <value>` (value). Values: `filed`, `under_review`, `approved`, `denied`, `paid`, `reversed`.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe claim view

View one BanSafe attribution claim.

### Usage

```bash
polymorfa bansafe claim view CLAIM [flags]
```

### Arguments

- `CLAIM` (required). Claim ID.

### Flags

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe collection list

List BanSafe telemetry collection status for one project.

### Usage

```bash
polymorfa bansafe collection list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from an opaque page cursor.
- `--limit <value>` (value). Maximum sessions to return (default 25).
- `--project <value>` (value, required). Project ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe enforcement list

List recorded BanSafe enforcement for one project.

### Usage

```bash
polymorfa bansafe enforcement list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from an opaque page cursor.
- `--limit <value>` (value).
- `--project <value>` (value, required). Project ID.
- `--rung <value>` (value). Values: `none`, `notify`, `throttle`, `block_cold`, `suspend`.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe finding list

List measured BanSafe findings for one project.

### Usage

```bash
polymorfa bansafe finding list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from an opaque page cursor.
- `--limit <value>` (value).
- `--project <value>` (value, required). Project ID.
- `--session <value>` (value). Match one session ID or name.
- `--severity <value>` (value). Values: `info`, `warning`, `critical`.
- `--status <value>` (value). Values: `open`, `acknowledged`, `resolved`.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe health history

List recorded BanSafe Health evaluations for one session.

### Usage

```bash
polymorfa bansafe health history SESSION [flags]
```

### Arguments

- `SESSION` (required). Session ID or name.

### Flags

- `--limit <value>` (value). Maximum evaluations to return (default 720).
- `--since <value>` (value). Include evaluations at or after this ISO 8601 instant.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe health list

List current BanSafe Health for one project.

### Usage

```bash
polymorfa bansafe health list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from an opaque page cursor.
- `--limit <value>` (value). Maximum sessions to return (default 25).
- `--project <value>` (value, required). Project ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe health view

View current BanSafe Health for one session.

### Usage

```bash
polymorfa bansafe health view SESSION [flags]
```

### Arguments

- `SESSION` (required). Session ID or name.

### Flags

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe health-action list

List durable BanSafe Health actions for one project.

### Usage

```bash
polymorfa bansafe health-action list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from an opaque page cursor.
- `--limit <value>` (value). Maximum actions to return (default 25).
- `--project <value>` (value, required). Project ID.
- `--session <value>` (value). Match one session ID or name.
- `--status <value>` (value). Match one action status. Values: `pending`, `running`, `succeeded`, `failed`, `cancelled`.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe health-policy update

Replace the BanSafe Health rule for one project.

### Usage

```bash
polymorfa bansafe health-policy update [flags]
```

### Flags

- `--idempotency-key <value>` (value, required). Identify retries of this convergent policy update.
- `--input <value>` (value, required). Read the complete policy JSON object from a file or standard input (-).
- `--project <value>` (value, required). Project ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe health-policy view

View the BanSafe Health rule for one project.

### Usage

```bash
polymorfa bansafe health-policy view [flags]
```

### Flags

- `--project <value>` (value, required). Project ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe incident list

List recorded BanSafe incidents for one project.

### Usage

```bash
polymorfa bansafe incident list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from an opaque page cursor.
- `--limit <value>` (value).
- `--project <value>` (value, required). Project ID.
- `--session <value>` (value). Match one session ID or name.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe incident report

Report a customer-observed BanSafe incident.

### Usage

```bash
polymorfa bansafe incident report [flags]
```

### Flags

- `--idempotency-key <value>` (value, required). Identify retries of this incident report.
- `--note <value>` (value). Optional incident context.
- `--occurred-at <value>` (value). Observed ISO 8601 instant.
- `--session <value>` (value, required). Session ID or name.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe incident retract

Retract one customer-reported BanSafe incident.

### Usage

```bash
polymorfa bansafe incident retract INCIDENT [flags]
```

### Arguments

- `INCIDENT` (required). Incident ID.

### Flags

- `--idempotency-key <value>` (value, required). Identify retries of this retraction.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe insurance-evidence update

Update project insurance evidence collection.

### Usage

```bash
polymorfa bansafe insurance-evidence update [flags]
```

### Flags

- `--idempotency-key <value>` (value, required). Identify retries of this update.
- `--input <value>` (value, required). Read an insurance-evidence JSON object from a file or standard input (-).
- `--project <value>` (value, required). Project ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe insurance-evidence view

View project insurance evidence collection.

### Usage

```bash
polymorfa bansafe insurance-evidence view [flags]
```

### Flags

- `--project <value>` (value, required). Project ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe safe-mode update

Update project or session Safe Mode settings.

### Usage

```bash
polymorfa bansafe safe-mode update [SESSION] [flags]
```

### Arguments

- `SESSION` (optional). Session ID or name.

### Flags

- `--idempotency-key <value>` (value, required). Identify retries of this update.
- `--input <value>` (value, required). Read a Safe Mode JSON patch from a file or standard input (-).
- `--project <value>` (value). Project ID; required when session is omitted.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe safe-mode view

View project or effective session Safe Mode.

### Usage

```bash
polymorfa bansafe safe-mode view [SESSION] [flags]
```

### Arguments

- `SESSION` (optional). Session ID or name.

### Flags

- `--project <value>` (value). Project ID; required when session is omitted.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe signal list

List the bounded BanSafe telemetry signal catalogue.

### Usage

```bash
polymorfa bansafe signal list [flags]
```

### Flags

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe telemetry history

List bounded BanSafe telemetry snapshots for one session.

### Usage

```bash
polymorfa bansafe telemetry history SESSION [flags]
```

### Arguments

- `SESSION` (required). Session ID or name.

### Flags

- `--cursor <value>` (value). Continue from an opaque page cursor.
- `--limit <value>` (value). Maximum snapshots to return (default 10).
- `--since <value>` (value). Include snapshots at or after this ISO 8601 instant.
- `--until <value>` (value). Include snapshots at or before this ISO 8601 instant.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe telemetry view

View the latest bounded BanSafe telemetry for one session.

### Usage

```bash
polymorfa bansafe telemetry view SESSION [flags]
```

### Arguments

- `SESSION` (required). Session ID or name.

### Flags

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe warmup update

Update the warmup plan for one project.

### Usage

```bash
polymorfa bansafe warmup update [flags]
```

### Flags

- `--idempotency-key <value>` (value, required). Identify retries of this update.
- `--input <value>` (value, required). Read a warmup-plan JSON patch from a file or standard input (-).
- `--project <value>` (value, required). Project ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa bansafe warmup view

View the warmup plan for one project.

### Usage

```bash
polymorfa bansafe warmup view [flags]
```

### Flags

- `--project <value>` (value, required). Project ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).
