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

# bijection scenario

> Start, observe, recover and repeat scenario runs

## bijection scenario

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Start a declared scenario case as a native run. Resume continues the same run; recompute and resample admit new runs from a saved start request; recover resends an uncertain submission under its original identity.

Start: bijection scenario start replenish demand-spike --from <checkpoint> --output run.json
Start fresh from a run's output: bijection scenario start logistics outage --from <output-checkpoint> --fresh
Repeat: bijection scenario recompute run.json; bijection scenario resample run.json --seed restock-43

Usage:
  bijection scenario [flags]
  bijection scenario [command]

Available Commands:
  cancel      Cancel a retained scenario run
  get         Get a retained scenario run
  pending     List one caller-scoped page of uncertain submissions
  recompute   Admit a new run of a saved start request with the same inputs and sampling controls
  recover     Resend an uncertain run, experiment or program submission under its original identity
  report      Report a retained scenario run
  resample    Admit a new run of a saved start request that changes only its seed
  resume      Resume a retained scenario run
  retire      Retire a retained scenario run
  start       Plan a declared case and admit it as a run

Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                help for scenario
      --help-all            Show all commands and options, including administrative controls.
      --url string          Run scenarios on a private deployment at this explicit origin.

Use "bijection scenario [command] --help" for more information about a command.
```

## bijection scenario cancel

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Cancel a retained scenario run

Usage:
  bijection scenario cancel <id> [flags]

Flags:
  -h, --help            help for cancel
      --help-all        Show all commands and options, including administrative controls.
      --output string   Save the exact native response as a private JSON file

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario get

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Get a retained scenario run

Usage:
  bijection scenario get <id> [flags]

Flags:
  -h, --help            help for get
      --help-all        Show all commands and options, including administrative controls.
      --output string   Save the exact native response as a private JSON file

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario pending

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
List one caller-scoped page of uncertain submissions

Usage:
  bijection scenario pending [flags]

Flags:
      --cursor string   Continue the original local journal listing
  -h, --help            help for pending
      --help-all        Show all commands and options, including administrative controls.

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario recompute

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Admit a new run of a saved start request with the same inputs and sampling controls

Usage:
  bijection scenario recompute <request-file> [flags]

Flags:
  -h, --help            help for recompute
      --help-all        Show all commands and options, including administrative controls.
      --output string   Save the exact start request before admission, to recompute, resample or recover it
      --run-id string   Admit under this run identity instead of a new one

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario recover

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Resend an uncertain run, experiment or program submission under its original identity

Usage:
  bijection scenario recover <submission-file> [flags]

Flags:
  -h, --help       help for recover
      --help-all   Show all commands and options, including administrative controls.

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario report

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Report a retained scenario run

Usage:
  bijection scenario report <id> [flags]

Flags:
  -h, --help            help for report
      --help-all        Show all commands and options, including administrative controls.
      --output string   Save the exact native response as a private JSON file

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario resample

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Admit a new run of a saved start request that changes only its seed

Usage:
  bijection scenario resample <request-file> [flags]

Flags:
  -h, --help            help for resample
      --help-all        Show all commands and options, including administrative controls.
      --output string   Save the exact start request before admission, to recompute, resample or recover it
      --run-id string   Admit under this run identity instead of a new one
      --seed string     New business random seed

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario resume

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Resume a retained scenario run

Usage:
  bijection scenario resume <id> [flags]

Flags:
  -h, --help            help for resume
      --help-all        Show all commands and options, including administrative controls.
      --output string   Save the exact native response as a private JSON file

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario retire

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Retire a retained scenario run

Usage:
  bijection scenario retire <id> [flags]

Flags:
  -h, --help            help for retire
      --help-all        Show all commands and options, including administrative controls.
      --output string   Save the exact native response as a private JSON file

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```

## bijection scenario start

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Plan a declared case and admit it as a run

Usage:
  bijection scenario start <scenario> <case> [flags]

Flags:
      --evidence-hours int   Retain authorized evidence for 1–720 hours
      --fresh                Start new work from the checkpoint's state instead of continuing the execution that produced it
      --from string          Exact native checkpoint UUID
  -h, --help                 help for start
      --help-all             Show all commands and options, including administrative controls.
      --histories string     Captured observation histories as native JSON
      --output string        Save the exact start request before admission, to recompute, resample or recover it
      --output-hours int     Retain output for 0–72 hours; requires explicit evidence retention
      --program string       Captured candidate program identity
      --run-id string        Admit under this run identity instead of a new one
      --seed string          Retained business random seed
      --start-ms int         Exact nonnegative business time in milliseconds

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Run scenarios on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --url string          Run scenarios on a private deployment at this explicit origin.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.