# prb finding command reference

Manage findings. This page documents **7 commands** under `prb finding`.

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

## prb finding

Manage findings.

### Usage

```text
prb finding <command>
```

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

## prb finding create

Create a new finding.

### Usage

```text
prb finding create
```

Accepts no positional arguments.

### Flags

| Flag                    | Type   | Default | Required | Description                                                                               |
| ----------------------- | ------ | ------- | -------- | ----------------------------------------------------------------------------------------- |
| `--corrective-action`   | string | `""`    | —        | Corrective action                                                                         |
| `--description`         | string | `""`    | —        | Finding description                                                                       |
| `--due-date`            | string | `""`    | —        | Due date (RFC3339)                                                                        |
| `--effectiveness-check` | string | `""`    | —        | Effectiveness check                                                                       |
| `--identified-on`       | string | `""`    | —        | Date identified (RFC3339)                                                                 |
| `--kind`                | string | `""`    | Required | Finding kind: MINOR_NONCONFORMITY, MAJOR_NONCONFORMITY, OBSERVATION, EXCEPTION (required) |
| `--org`                 | string | `""`    | —        | Organization ID                                                                           |
| `--owner-id`            | string | `""`    | —        | Owner profile ID                                                                          |
| `--priority`            | string | `""`    | Required | Priority: LOW, MEDIUM, HIGH (required)                                                    |
| `--risk-id`             | string | `""`    | —        | Associated risk ID                                                                        |
| `--root-cause`          | string | `""`    | —        | Root cause                                                                                |
| `--source`              | string | `""`    | —        | Finding source                                                                            |
| `--status`              | string | `""`    | Required | Status: OPEN, IN_PROGRESS, CLOSED, RISK_ACCEPTED, MITIGATED, FALSE_POSITIVE (required)    |

### Examples

```bash
# Create a finding
prb finding create --org ORG_ID --kind MINOR_NONCONFORMITY --owner-id OWNER_ID --status OPEN --priority HIGH
```

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

## prb finding delete

Delete a finding.

### Usage

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

## prb finding list

List findings in an organization.

### Usage

```text
prb finding list
```

Accepts no positional arguments.

### Flags

| Flag                | Type    | Default  | Required | Description                                                                                |
| ------------------- | ------- | -------- | -------- | ------------------------------------------------------------------------------------------ |
| `--after`           | string  | `""`     | —        | Cursor from the previous page (the Next cursor line)                                       |
| `--audit`           | string  | `""`     | —        | Filter by audit ID                                                                         |
| `--json`            | boolean | `false`  | —        | Output JSON (same as --output json)                                                        |
| `--kind`            | string  | `""`     | —        | Filter by kind (MINOR_NONCONFORMITY, MAJOR_NONCONFORMITY, OBSERVATION, EXCEPTION)          |
| `--limit`, `-L`     | integer | `30`     | —        | Maximum number of findings to list                                                         |
| `--order-by`        | string  | `""`     | —        | Order by field (CREATED_AT, REFERENCE_ID, IDENTIFIED_ON, DUE_DATE, STATUS, PRIORITY, KIND) |
| `--order-direction` | string  | `"DESC"` | —        | Sort direction (ASC, DESC)                                                                 |
| `--org`             | string  | `""`     | —        | Organization ID                                                                            |
| `--output`, `-o`    | string  | `""`     | —        | Output format: json, table (default)                                                       |

### Examples

```bash
# List findings in an organization
prb finding list --org <organization-id>

# Filter by kind and output as JSON
prb finding ls --org <organization-id> --kind MINOR_NONCONFORMITY --output json

# List findings linked to an audit
prb finding ls --org <organization-id> --audit <audit-id>
```

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

## prb finding publish

Publish the finding register as a document version.

### Usage

```text
prb finding 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 finding register
prb finding publish --org ORG_ID

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

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

## prb finding update

Update a finding.

### Usage

```text
prb finding update <id>
```

Requires 1 positional argument.

### Flags

| Flag                    | Type   | Default | Required | Description                                                                 |
| ----------------------- | ------ | ------- | -------- | --------------------------------------------------------------------------- |
| `--corrective-action`   | string | `""`    | —        | Corrective action                                                           |
| `--description`         | string | `""`    | —        | Finding description                                                         |
| `--due-date`            | string | `""`    | —        | Due date (RFC3339)                                                          |
| `--effectiveness-check` | string | `""`    | —        | Effectiveness check                                                         |
| `--identified-on`       | string | `""`    | —        | Date identified (RFC3339)                                                   |
| `--owner-id`            | string | `""`    | —        | Owner profile ID                                                            |
| `--priority`            | string | `""`    | —        | Priority: LOW, MEDIUM, HIGH                                                 |
| `--risk-id`             | string | `""`    | —        | Associated risk ID                                                          |
| `--root-cause`          | string | `""`    | —        | Root cause                                                                  |
| `--source`              | string | `""`    | —        | Finding source                                                              |
| `--status`              | string | `""`    | —        | Status: OPEN, IN_PROGRESS, CLOSED, RISK_ACCEPTED, MITIGATED, FALSE_POSITIVE |

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

## prb finding view

View a finding.

### Usage

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