# prb datum command reference

Manage data. This page documents **7 commands** under `prb datum`.

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 datum`](#prb-datum)                 | Manage data.                                 | `prb datum <command>`   | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/datum/datum.go#L35)           |
| [`prb datum create`](#prb-datum-create)   | Create a new datum.                          | `prb datum create`      | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/datum/create/create.go#L68)   |
| [`prb datum delete`](#prb-datum-delete)   | Delete a datum.                              | `prb datum delete <id>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/datum/delete/delete.go#L43)   |
| [`prb datum list`](#prb-datum-list)       | List data in an organization.                | `prb datum list`        | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/datum/list/list.go#L71)       |
| [`prb datum publish`](#prb-datum-publish) | Publish the data list as a document version. | `prb datum publish`     | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/datum/publish/publish.go#L83) |
| [`prb datum update`](#prb-datum-update)   | Update a datum.                              | `prb datum update <id>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/datum/update/update.go#L62)   |
| [`prb datum view`](#prb-datum-view)       | View a datum.                                | `prb datum view <id>`   | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/datum/view/view.go#L62)       |

## prb datum

Manage data.

### Usage

```text
prb datum <command>
```

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

## prb datum create

Create a new datum.

### Usage

```text
prb datum create
```

### Flags

| Flag                    | Type        | Default | Required | Description                                                            |
| ----------------------- | ----------- | ------- | -------- | ---------------------------------------------------------------------- |
| `--data-classification` | string      | `""`    | —        | Data classification: PUBLIC, INTERNAL, CONFIDENTIAL, SECRET (required) |
| `--name`                | string      | `""`    | —        | Datum name (required)                                                  |
| `--org`                 | string      | `""`    | —        | Organization ID                                                        |
| `--owner`               | string      | `""`    | —        | Owner profile ID (required)                                            |
| `--third-party-ids`     | string list | `[]`    | —        | Third party IDs (comma-separated)                                      |

### Examples

```bash
# Create a datum interactively
prb datum create

# Create a datum non-interactively
prb datum create --name "Customer PII" --data-classification CONFIDENTIAL --owner <profile-id>
```

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

## prb datum delete

Delete a datum.

### Usage

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

## prb datum list

List data in an organization.

### Usage

```text
prb datum 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 to list                         |
| `--order-by`        | string  | `""`     | —        | Order by field (CREATED_AT, NAME, DATA_CLASSIFICATION) |
| `--order-direction` | string  | `"DESC"` | —        | Sort direction (ASC, DESC)                             |
| `--org`             | string  | `""`     | —        | Organization ID                                        |
| `--output`, `-o`    | string  | `""`     | —        | Output format: json, table (default)                   |

### Examples

```bash
# List data in the default organization
prb datum list

# List data sorted by name
prb datum ls --order-by NAME --output json
```

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

## prb datum publish

Publish the data list as a document version.

### Usage

```text
prb datum 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 data list
prb datum publish --org ORG_ID

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

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

## prb datum update

Update a datum.

### Usage

```text
prb datum update <id>
```

Requires 1 positional argument.

### Flags

| Flag                    | Type        | Default | Required | Description                                                 |
| ----------------------- | ----------- | ------- | -------- | ----------------------------------------------------------- |
| `--data-classification` | string      | `""`    | —        | Data classification: PUBLIC, INTERNAL, CONFIDENTIAL, SECRET |
| `--name`                | string      | `""`    | —        | Datum name                                                  |
| `--owner`               | string      | `""`    | —        | Owner profile ID                                            |
| `--third-party-ids`     | string list | `[]`    | —        | Third party IDs (comma-separated)                           |

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

## prb datum view

View a datum.

### Usage

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