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

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

## bijection file

```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 file [flags]
  bijection file [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 file
      --help-all   Show all commands and options, including administrative controls.

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

## bijection file download

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

Usage:
  bijection file 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.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                help for download
      --help-all            Show all commands and options, including administrative controls.
  -o, --output string       Save verified bytes to a new file.
      --path string         Concrete JSON pointer within --record, such as /files/0/file.
      --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.
```

## bijection file 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 file 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.
      --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.
      --url string          List from the deployment at the given URL.
```


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