---
title: "tractorbeam blobs"
description: "Upload the files Blob fields reference."
sidebar:
  label: "blobs"
  order: 16
---

```sh
tractorbeam blobs <subcommand> [flags]
```

## Shared flags

Every subcommand takes these flags.

| Flag | Description |
| --- | --- |
| `--config <string>` | The Project's `tractorbeam.config.ts`. Defaults to the one in the current directory or its nearest ancestor. |
| `--workspace <string>` | Workspace identifier or resource name. Environment variable: `TRACTORBEAM_WORKSPACE`. |
| `--origin <string>` | The Tractorbeam origin to call instead of the default, such as a proxy's. Environment variable: `TRACTORBEAM_ORIGIN`. |
| `--token <string>` | Access token. Defaults to the saved interactive session. Environment variable: `TRACTORBEAM_TOKEN`. |

## `blobs upload`

Upload a file as a Blob of the Workspace and print the reference a Blob field holds.

```sh
tractorbeam blobs upload [flags] <file>
```

| Argument | Description |
| --- | --- |
| `<file>` | The file to upload. |

| Flag | Description |
| --- | --- |
| `--media-type <string>` | The file's media type. Defaults to one its extension names. |
| `--table <string>` | A Table whose Blob field `--field` checks the file before it uploads. |
| `--field <string>` | The Blob field of `--table` the file is for. |

Examples:

```sh
# Upload logo.png and print its reference
tractorbeam blobs upload logo.png

# Check the file against the contracts Table's document field, then upload it
tractorbeam blobs upload contract.pdf --table contracts --field document
```
