# prb evidence command reference

Manage evidences. This page documents **5 commands** under `prb evidence`.

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 evidence`](#prb-evidence)               | Manage evidences.                        | `prb evidence <command>`     | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/evidence/evidence.go#L33)      |
| [`prb evidence delete`](#prb-evidence-delete) | Delete an evidence.                      | `prb evidence delete <id>`   | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/evidence/delete/delete.go#L50) |
| [`prb evidence list`](#prb-evidence-list)     | List evidences for an internal control.  | `prb evidence list`          | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/evidence/list/list.go#L77)     |
| [`prb evidence upload`](#prb-evidence-upload) | Upload evidence for an internal control. | `prb evidence upload <file>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/evidence/upload/upload.go#L63) |
| [`prb evidence view`](#prb-evidence-view)     | View an evidence.                        | `prb evidence view <id>`     | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/evidence/view/view.go#L90)     |

## prb evidence

Manage evidences.

### Usage

```text
prb evidence <command>
```

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

## prb evidence delete

Delete an evidence.

### Usage

```text
prb evidence delete <id>
```

Requires 1 positional argument.

### Flags

| Flag          | Type    | Default | Required | Description              |
| ------------- | ------- | ------- | -------- | ------------------------ |
| `--yes`, `-y` | boolean | `false` | —        | Skip confirmation prompt |

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

## prb evidence list

List evidences for an internal control.

### Usage

```text
prb evidence list
```

Accepts no positional arguments.

### Flags

| Flag                 | Type    | Default  | Required | Description                                          |
| -------------------- | ------- | -------- | -------- | ---------------------------------------------------- |
| `--after`            | string  | `""`     | —        | Cursor from the previous page (the Next cursor line) |
| `--internal-control` | string  | `""`     | Required | Internal control ID (required)                       |
| `--json`             | boolean | `false`  | —        | Output JSON (same as --output json)                  |
| `--limit`, `-L`      | integer | `30`     | —        | Maximum number of evidences to list                  |
| `--order-by`         | string  | `""`     | —        | Order by field (CREATED_AT)                          |
| `--order-direction`  | string  | `"DESC"` | —        | Sort direction (ASC, DESC)                           |
| `--output`, `-o`     | string  | `""`     | —        | Output format: json, table (default)                 |

### Examples

```bash
# List evidences for an internal control
prb evidence list --internal-control <internal-control-id>

# Output as JSON
prb evidence ls --internal-control <internal-control-id> --output json
```

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

## prb evidence upload

Upload evidence for an internal control.

### Usage

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

Requires 1 positional argument.

### Flags

| Flag                 | Type   | Default | Required | Description                    |
| -------------------- | ------ | ------- | -------- | ------------------------------ |
| `--internal-control` | string | `""`    | Required | Internal control ID (required) |

### Examples

```bash
# Upload a file as evidence for an internal control
prb evidence upload ./report.pdf --internal-control <internal-control-id>
```

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

## prb evidence view

View an evidence.

### Usage

```text
prb evidence view <id>
```

Requires 1 positional argument.

### Flags

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

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