# prb audit-log command reference

Manage audit log entries. This page documents **4 commands** under `prb audit-log`.

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 audit-log`](#prb-audit-log)               | Manage audit log entries. | `prb audit-log <command>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auditlog/audit_log.go#L32)     |
| [`prb audit-log export`](#prb-audit-log-export) | Export audit log entries. | `prb audit-log export`    | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auditlog/export/export.go#L47) |
| [`prb audit-log list`](#prb-audit-log-list)     | List audit log entries.   | `prb audit-log list`      | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auditlog/list/list.go#L83)     |
| [`prb audit-log view`](#prb-audit-log-view)     | View an audit log entry.  | `prb audit-log view <id>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auditlog/view/view.go#L66)     |

## prb audit-log

Manage audit log entries.

### Usage

```text
prb audit-log <command>
```

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

## prb audit-log export

Export audit log entries.

### Usage

```text
prb audit-log export
```

Accepts no positional arguments.

### Flags

| Flag     | Type   | Default | Required | Description                                              |
| -------- | ------ | ------- | -------- | -------------------------------------------------------- |
| `--from` | string | `""`    | —        | Start time in RFC3339 format (e.g. 2026-01-01T00:00:00Z) |
| `--org`  | string | `""`    | —        | Organization ID                                          |
| `--to`   | string | `""`    | —        | End time in RFC3339 format (e.g. 2026-02-01T00:00:00Z)   |

### Examples

```bash
prb audit-log export --org <id> --from 2026-01-01T00:00:00Z --to 2026-02-01T00:00:00Z
prb audit-log export --from 2026-03-01T00:00:00Z --to 2026-03-24T00:00:00Z
```

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

## prb audit-log list

List audit log entries.

### Usage

```text
prb audit-log list
```

Accepts no positional arguments.

### Flags

| Flag                | Type    | Default  | Required | Description                                          |
| ------------------- | ------- | -------- | -------- | ---------------------------------------------------- |
| `--action`          | string  | `""`     | —        | Filter by action (e.g. core:thirdParty:create)       |
| `--actor-id`        | string  | `""`     | —        | Filter by actor ID                                   |
| `--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 entries 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)                 |
| `--resource-id`     | string  | `""`     | —        | Filter by resource ID                                |
| `--resource-type`   | string  | `""`     | —        | Filter by resource type (e.g. ThirdParty)            |

### Examples

```bash
prb audit-log list
prb audit-log list --action core:thirdParty:create
prb audit-log list --resource-type ThirdParty --limit 50
```

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

## prb audit-log view

View an audit log entry.

### Usage

```text
prb audit-log 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) |

### Examples

```bash
prb audit-log view <audit-log-entry-id>
```

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