> ## 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 program

> Capture, inspect, retire and promote candidate program code

## bijection program

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Freeze a branch's exact code as a candidate program for scenario runs and experiments, and promote a holdout-selected program into a reviewable branch. Publish reviewed code with bijection branch publish.

Usage:
  bijection program [flags]
  bijection program [command]

Available Commands:
  capture     Capture a retained program
  get         Get a retained program
  promote     Promote a retained program
  promotion   Promotion a retained program
  retire      Retire a retained program

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 program
      --help-all            Show all commands and options, including administrative controls.
      --url string          Run scenarios on a private deployment at this explicit origin.

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

## bijection program capture

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Capture a retained program

Usage:
  bijection program capture <request-file> [flags]

Flags:
  -h, --help            help for capture
      --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 program get

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

Usage:
  bijection program 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 program promote

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Promote a retained program

Usage:
  bijection program promote <request-file> [flags]

Flags:
  -h, --help            help for promote
      --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 program promotion

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Promotion a retained program

Usage:
  bijection program promotion <id> [flags]

Flags:
  -h, --help            help for promotion
      --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 program retire

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

Usage:
  bijection program 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.
```


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