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

> Start, observe, order and select paired experiments

## bijection experiment

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Admit a captured experiment matrix of scenario runs and read its paired evidence. Selection records a choice; review and application stay separate. Recover an uncertain submission with bijection scenario recover.

Usage:
  bijection experiment [flags]
  bijection experiment [command]

Available Commands:
  cancel      Cancel a retained experiment
  get         Get a retained experiment
  holdout     Holdout a retained experiment
  order       Order a retained experiment
  report      Report a retained experiment
  resume      Resume a retained experiment
  retire      Retire a retained experiment
  select      Select a retained experiment
  selection   Selection a retained experiment
  start       Start a retained experiment

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

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

## bijection experiment cancel

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

Usage:
  bijection experiment 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 experiment get

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

Usage:
  bijection experiment 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 experiment holdout

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

Usage:
  bijection experiment holdout <request-file> [flags]

Flags:
  -h, --help            help for holdout
      --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 experiment order

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

Usage:
  bijection experiment order <request-file> [flags]

Flags:
  -h, --help            help for order
      --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 experiment report

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

Usage:
  bijection experiment 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 experiment resume

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

Usage:
  bijection experiment 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 experiment retire

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

Usage:
  bijection experiment 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 experiment select

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

Usage:
  bijection experiment select <request-file> [flags]

Flags:
  -h, --help            help for select
      --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 experiment selection

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

Usage:
  bijection experiment selection <id> [flags]

Flags:
  -h, --help            help for selection
      --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 experiment start

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

Usage:
  bijection experiment start <request-file> [flags]

Flags:
  -h, --help            help for start
      --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.