# prb dpia command reference

Manage data protection impact assessments. This page documents **7 commands** under `prb dpia`.

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 dpia`](#prb-dpia)                 | Manage data protection impact assessments.                                    | `prb dpia <command>`   | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/dpia/dpia.go#L35)            |
| [`prb dpia create`](#prb-dpia-create)   | Create a new data protection impact assessment.                               | `prb dpia create`      | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/dpia/create/create.go#L65)   |
| [`prb dpia delete`](#prb-dpia-delete)   | Delete a data protection impact assessment.                                   | `prb dpia delete <id>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/dpia/delete/delete.go#L43)   |
| [`prb dpia list`](#prb-dpia-list)       | List data protection impact assessments in an organization.                   | `prb dpia list`        | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/dpia/list/list.go#L81)       |
| [`prb dpia publish`](#prb-dpia-publish) | Publish the Data Protection Impact Assessment register as a document version. | `prb dpia publish`     | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/dpia/publish/publish.go#L83) |
| [`prb dpia update`](#prb-dpia-update)   | Update a data protection impact assessment.                                   | `prb dpia update <id>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/dpia/update/update.go#L63)   |
| [`prb dpia view`](#prb-dpia-view)       | View a data protection impact assessment.                                     | `prb dpia view <id>`   | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/dpia/view/view.go#L68)       |

## prb dpia

Manage data protection impact assessments.

### Usage

```text
prb dpia <command>
```

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

## prb dpia create

Create a new data protection impact assessment.

### Usage

```text
prb dpia create
```

### Flags

| Flag                    | Type   | Default | Required | Description                       |
| ----------------------- | ------ | ------- | -------- | --------------------------------- |
| `--description`         | string | `""`    | —        | Description                       |
| `--mitigations`         | string | `""`    | —        | Mitigations                       |
| `--necessity`           | string | `""`    | —        | Necessity and proportionality     |
| `--potential-risk`      | string | `""`    | —        | Potential risk                    |
| `--processing-activity` | string | `""`    | Required | Processing activity ID (required) |
| `--residual-risk`       | string | `""`    | —        | Residual risk: LOW, MEDIUM, HIGH  |

### Examples

```bash
# Create a DPIA
prb dpia create --processing-activity <id> --description "Assessment for HR processing"

# Create a DPIA with all fields
prb dpia create --processing-activity <id> --description "Assessment" --necessity "Required by law" --potential-risk "Data leak" --mitigations "Encryption" --residual-risk LOW
```

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

## prb dpia delete

Delete a data protection impact assessment.

### Usage

```text
prb dpia 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/dpia/delete/delete.go#L43).

## prb dpia list

List data protection impact assessments in an organization.

### Usage

```text
prb dpia list
```

Accepts no positional arguments.

### Flags

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

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

## prb dpia publish

Publish the Data Protection Impact Assessment register as a document version.

### Usage

```text
prb dpia publish
```

### Flags

| Flag         | Type         | Default | Required | Description                                                 |
| ------------ | ------------ | ------- | -------- | ----------------------------------------------------------- |
| `--approver` | string array | `[]`    | —        | Approver profile ID (can be repeated; ignored with --minor) |
| `--minor`    | boolean      | `false` | —        | Publish as a minor version (no approval flow)               |
| `--org`      | string       | `""`    | —        | Organization ID                                             |

### Examples

```bash
# Publish the DPIA register
prb dpia publish --org ORG_ID

# Publish with approvers
prb dpia publish --org ORG_ID --approver PROFILE_ID1 --approver PROFILE_ID2
```

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

## prb dpia update

Update a data protection impact assessment.

### Usage

```text
prb dpia update <id>
```

Requires 1 positional argument.

### Flags

| Flag               | Type   | Default | Required | Description                      |
| ------------------ | ------ | ------- | -------- | -------------------------------- |
| `--description`    | string | `""`    | —        | Description                      |
| `--mitigations`    | string | `""`    | —        | Mitigations                      |
| `--necessity`      | string | `""`    | —        | Necessity and proportionality    |
| `--potential-risk` | string | `""`    | —        | Potential risk                   |
| `--residual-risk`  | string | `""`    | —        | Residual risk: LOW, MEDIUM, HIGH |

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

## prb dpia view

View a data protection impact assessment.

### Usage

```text
prb dpia 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/dpia/view/view.go#L68).