Skip to main content
Branches are in beta.
Manage branches of the selected deployment. A branch is a fork of the deployment’s committed data at a pinned revision; external calls made on it are held and never leave it.
  • Create: bijection branch create what-if
  • Compare: bijection branch compare what-if items:list
  • Apply: bijection branch apply what-if --commit

Syntax

Options

These options choose the parent deployment for every subcommand. Without them, bijection branch manages branches of your dev deployment. You can also select the parent with --url <url> --admin-key <adminKey>, or with --env-file <envFile> naming a file that sets BIJECTION_DEPLOYMENT or BIJECTION_SELF_HOSTED_URL. A branch URL is refused: branches are managed on their parent, with the parent’s admin key.

Subcommands

Every <key> is 1 to 40 lowercase letters, digits or hyphens, starting with a letter or digit. If a command that changes a branch gets no response, the CLI can’t tell whether the change took effect. Check with bijection branch status before retrying.

bijection branch create

Fork the deployment’s committed data at its current revision.

Syntax

Arguments

Options

bijection branch list

List branches you can open.

Syntax

Options

bijection branch status

Show one branch: its state, basis, expiry, owner, users it is shared with, how far you have applied it, and a fresh personal link.

Syntax

Arguments

Options

bijection branch share

Let users open the branch with their own identity. Only the branch’s owner or an administrator can share it.

Syntax

Arguments

bijection branch unshare

Stop letting users open the branch with their own identity. Takes effect at once, including for open connections.

Syntax

Arguments

bijection branch extend

Move the branch expiry. The basis does not move, and a branch that has already expired can’t be extended.

Syntax

Arguments

Options

bijection branch discard

Discard the branch and everything committed on it. What was already applied to live stays applied.

Syntax

Arguments

bijection branch compare

Run a query on the branch and on its parent and compare the results. The parent is read at the branch’s basis.

Syntax

Arguments

Options

bijection branch apply

Preview replaying your branch operations not yet applied onto live; --commit applies them. See apply and rebase. Exits with an error when the preview or the commit is refused or diverged.

Syntax

Arguments

Options

bijection branch rebase

Replay your branch operations onto a fresh fork of live. The original branch is kept. Only the branch’s owner or an administrator can rebase it.

Syntax

Arguments

Options