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

> List and download the files your records hold; upload with `bijection run <operation> file=@path`

## bijection files

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
List and download the files your records hold; upload with `bijection run <operation> file=@path`

Usage:
  bijection files [flags]
  bijection files [command]

Available Commands:
  download    Download an exact file using your current business permissions
  list        List the files a record holds, with their names, sizes and types

Flags:
  -h, --help   help for files

Global Flags:
      --help-all   Show all commands and options, including administrative controls.

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

## bijection files download

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Download an exact file using your current business permissions

Usage:
  bijection files download <file> [flags]

Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --attachment string   Read through an explicit relationship attachment.
      --branch string       Read from this branch as your verified identity.
      --component string    Component identity that owns the file.
      --deployment string   Download from 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 download
      --json                Print the file reference, output path, size and SHA-256 as JSON.
  -o, --output string       Save verified bytes to a new file.
      --path string         Concrete JSON pointer within --record, such as /files/0/file.
      --prod                Download from this project's default production deployment.
      --record string       Record containing the exact file property.
      --share string        Read through a share granted to your verified identity.
      --url string          Download from the deployment at the given URL.

Global Flags:
      --help-all   Show all commands and options, including administrative controls.
```

## bijection files list

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
List the files a record holds, with their names, sizes and types

Usage:
  bijection files list <record> [flags]

Flags:
      --as string           Act as a person, such as alice, on a development, preview or local deployment. Production refuses development identities.
      --branch string       Read from this branch as your verified identity.
      --deployment string   List from 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 list
      --json                Print each file's pointer, reference, name, size, type and SHA-256 as JSON.
      --prod                List from this project's default production deployment.
      --url string          List from the deployment at the given URL.

Global Flags:
      --help-all   Show all commands and options, including administrative controls.
```


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