# prb file command reference

Upload private files embedded in rich text. This page documents **2 commands** under `prb file`.

Flags and examples below come from the command definitions. A **Required** flag is explicitly marked required by Cobra; an unmarked flag can still be needed by runtime validation or a non-interactive workflow. Empty strings and empty lists are registered defaults, not sample values.

Every command also inherits the [global flags](/docs/developers/cli/commands#global-flags). Run `prb <command> --help` to check your installed version. Replace placeholder IDs and names in source examples before running them. Return to the [complete CLI command reference](/docs/developers/cli/commands) to browse another command.

## Commands

| Command                               | Description                                 | Usage                    | Source                                                                                                     |
| ------------------------------------- | ------------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
| [`prb file`](#prb-file)               | Upload private files embedded in rich text. | `prb file <command>`     | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/attachment/attachment.go#L30)    |
| [`prb file upload`](#prb-file-upload) | Upload a private file for rich text.        | `prb file upload <file>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/attachment/upload/upload.go#L65) |

## prb file

Upload private files embedded in rich text.

### Usage

```text
prb file <command>
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/attachment/attachment.go#L30).

## prb file upload

Upload a private file for rich text.

### Usage

```text
prb file upload <file>
```

Requires 1 positional argument.

### Flags

| Flag             | Type    | Default | Required | Description                          |
| ---------------- | ------- | ------- | -------- | ------------------------------------ |
| `--json`         | boolean | `false` | —        | Output JSON (same as --output json)  |
| `--org`          | string  | `""`    | —        | Organization ID                      |
| `--output`, `-o` | string  | `""`    | —        | Output format: json, table (default) |

### Examples

```bash
# Upload an image to use in a task or document
prb file upload ./diagram.png
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/attachment/upload/upload.go#L65).