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

> Capture, read, compare and release immutable snapshots

## bijection snapshot

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Capture exact live or branch state as an immutable snapshot. Fork it with bijection branch fork <name> --from <snapshot>, or start a scenario run from it with bijection scenario start --from <snapshot>.

Capture: bijection snapshot capture baseline --ttl-hours 24
Read: bijection snapshot query <snapshot> inventory:summary

Usage:
  bijection snapshot [flags]
  bijection snapshot [command]

Available Commands:
  capture     Capture exact live or branch state under a stable request key
  compare     Inspect exact snapshots across different bases without candidate ranking
  get         Inspect a retained capture by its request key
  query       Read a public query at a snapshot without a writable fork
  release     Release a snapshot; accepted descendants keep their claims

Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --deployment string   Capture snapshots of 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 snapshot
      --help-all            Show all commands and options, including administrative controls.
      --url string          Capture snapshots of a private deployment at this explicit origin.

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

## bijection snapshot capture

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Capture exact live or branch state under a stable request key

Usage:
  bijection snapshot capture <key> [flags]

Flags:
      --format string          Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                   help for capture
      --help-all               Show all commands and options, including administrative controls.
      --source-branch string   Capture this branch; omit for live
      --ttl-hours int          Retain for these hours

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

## bijection snapshot compare

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Inspect exact snapshots across different bases without candidate ranking

Usage:
  bijection snapshot compare <snapshot...> [flags]

Flags:
      --args string       Exact query arguments as an object (default "{}")
      --format string     Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help              help for compare
      --help-all          Show all commands and options, including administrative controls.
      --match-by string   Align rows by a unique business key
      --query string      Public query path

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

## bijection snapshot get

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Inspect a retained capture by its request key

Usage:
  bijection snapshot get <key> [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for get
      --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   Capture snapshots of 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          Capture snapshots of a private deployment at this explicit origin.
```

## bijection snapshot query

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Read a public query at a snapshot without a writable fork

Usage:
  bijection snapshot query <snapshot> <functionPath> [flags]

Flags:
      --args string     Exact query arguments as a JSON object (default "{}")
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for query
      --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   Capture snapshots of 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          Capture snapshots of a private deployment at this explicit origin.
```

## bijection snapshot release

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Release a snapshot; accepted descendants keep their claims

Usage:
  bijection snapshot release <snapshot> [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for release
      --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   Capture snapshots of 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          Capture snapshots of a private deployment at this explicit origin.
```


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