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

> Open, review and merge pull requests into protected live

## bijection pr

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
A pull request is a reviewed merge of one branch into live. It lives until it is merged or closed. Use it when live's ruleset requires review; otherwise merge with bijection branch merge.

Open: bijection pr create what-if --request <request-id>
Inspect: bijection pr view what-if; bijection pr diff what-if; bijection pr checks what-if
Approve: bijection pr review what-if --approve
Merge: bijection pr merge what-if, or --auto to merge once requirements pass

Usage:
  bijection pr [flags]
  bijection pr [command]

Available Commands:
  checks      Show the requirements a merge waits for; exits 8 while pending
  close       Close a pull request without merging; the branch stays
  create      Open a pull request to merge a branch into live
  diff        Show the assessed changes a merge would commit
  list        List pull requests you opened, or that wait for your review
  merge       Merge a pull request into live in one atomic commit
  review      Approve a pull request's current changes
  view        Show a pull request's state, checks and changes

Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
  -h, --help                help for pr
      --help-all            Show all commands and options, including administrative controls.
      --help-json           Print command input and output schemas as JSON without executing it.
      --url string          Use pull requests on a private deployment at this explicit origin.

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

## bijection pr checks

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Show the requirements a merge waits for; exits 8 while pending

Usage:
  bijection pr checks [pull-request] [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for checks
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
      --url string          Use pull requests on a private deployment at this explicit origin.
```

## bijection pr close

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Close a pull request without merging; the branch stays

Usage:
  bijection pr close [pull-request] [flags]

Flags:
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                help for close
      --help-all            Show all commands and options, including administrative controls.
      --help-json           Print command input and output schemas as JSON without executing it.
      --request-id string   Optional stable request identity; otherwise generated and retained before dispatch

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
      --url string          Use pull requests on a private deployment at this explicit origin.
```

## bijection pr create

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Open a pull request to merge a branch into live

Usage:
  bijection pr create [name] [flags]

Flags:
      --accept-breaking-contracts            On production: merge even though it removes or changes public functions that clients call
      --format string                        Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                                 help for create
      --help-all                             Show all commands and options, including administrative controls.
      --help-json                            Print command input and output schemas as JSON without executing it.
      --incompatible-scheduled-jobs string   On production: merge even though pending scheduled jobs cannot run under the new code; cancel cancels them, keep leaves them to fail (cancel, keep)
      --publish string                       Application mutation forwarding to pipelineAdoptionPublish, when no change plan names it
      --release string                       Install this captured or built Release instead of capturing a branch
      --request string                       Include one of your pending live Operations requests, by the request_id bijection operation run printed; repeat in commit order
      --request-id string                    Stable identity of this merge; repeat it with the same options to resume an interrupted merge

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
      --url string          Use pull requests on a private deployment at this explicit origin.
```

## bijection pr diff

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Show the assessed changes a merge would commit

Usage:
  bijection pr diff [pull-request] [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for diff
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
      --url string          Use pull requests on a private deployment at this explicit origin.
```

## bijection pr list

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
List pull requests you opened, or that wait for your review

Usage:
  bijection pr list [flags]

Flags:
      --cursor string      Continue from the previous page's next_cursor
      --format string      Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help               help for list
      --help-all           Show all commands and options, including administrative controls.
      --help-json          Print command input and output schemas as JSON without executing it.
      --review-requested   List pull requests waiting for your review

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
      --url string          Use pull requests on a private deployment at this explicit origin.
```

## bijection pr merge

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Merge a pull request into live in one atomic commit

Usage:
  bijection pr merge [pull-request] [flags]

Flags:
      --admin           Merge without waiting for requirements, as an actor on the ruleset's bypass list
      --auto            Wait until the requirements pass, then merge
      --details         Include exact revisions and operation details
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for merge
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
      --url string          Use pull requests on a private deployment at this explicit origin.
```

## bijection pr review

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Approve a pull request's current changes

Usage:
  bijection pr review [pull-request] [flags]

Flags:
      --approve             Approve the changes as assessed now; a changed branch needs a new approval
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                help for review
      --help-all            Show all commands and options, including administrative controls.
      --help-json           Print command input and output schemas as JSON without executing it.
      --request-id string   Optional stable request identity; otherwise generated and retained before dispatch

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
      --url string          Use pull requests on a private deployment at this explicit origin.
```

## bijection pr view

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Show a pull request's state, checks and changes

Usage:
  bijection pr view [pull-request] [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for view
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.

Global Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Use pull requests 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.
      --url string          Use pull requests on a private deployment at this explicit origin.
```


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