> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bronto.io/llms.txt
> Use this file to discover all available pages before exploring further.

# bronto forward-configs

> Manage forward configs

Manage forward configs

> [!TIP]
>
> * **Platform docs:** [docs.bronto.io/core-features/log-forwarding](https://docs.bronto.io/core-features/log-forwarding.md)
> * **API reference:** [docs.bronto.io/api-reference/forward/retrieve-forward-configs](https://docs.bronto.io/api-reference/forward/retrieve-forward-configs.md)

```sh theme={"dark"}
bronto forward-configs <command> [flags]
```

#### Subcommands

| Command | Description |
| - | - |
| [`bronto forward-configs create`](https://docs.bronto.io/cli/reference/commands/forward-configs#bronto-forward-configs-create) | Create a forward config |
| [`bronto forward-configs delete`](https://docs.bronto.io/cli/reference/commands/forward-configs#bronto-forward-configs-delete) | Delete a forward config |
| [`bronto forward-configs list`](https://docs.bronto.io/cli/reference/commands/forward-configs#bronto-forward-configs-list) | List forward configs |
| [`bronto forward-configs test`](https://docs.bronto.io/cli/reference/commands/forward-configs#bronto-forward-configs-test) | Check that Bronto can write to a forward config's S3 destination |
| [`bronto forward-configs update`](https://docs.bronto.io/cli/reference/commands/forward-configs#bronto-forward-configs-update) | Update a forward config |

Also accepts the [global flags](https://docs.bronto.io/cli/reference/commands/global-flags.md).

## bronto forward-configs create

Create a forward config

```sh theme={"dark"}
bronto forward-configs create [flags]
```

#### Flags

| Flag | Short | Type | Default | Description |
| - | - | - | - | - |
| `--field` | `-f` | stringArray | | request body field as key=value; values parse as JSON when possible (repeatable) |
| `--input` | | string | | read the request body from a file, or - for stdin |

Also accepts the [global flags](https://docs.bronto.io/cli/reference/commands/global-flags.md).

#### Examples

```sh theme={"dark"}
bronto forward-configs create -f name=<name> -f all_logs=true -f compression=GZIP \
    -f 'destination={"destination_type":"S3","bucket":"<bucket>"}'
bronto forward-configs create --input body.json
```

## bronto forward-configs delete

Delete a forward config

```sh theme={"dark"}
bronto forward-configs delete <id> [flags]
```

#### Flags

| Flag | Short | Type | Default | Description |
| - | - | - | - | - |
| `--yes` | | bool | | skip the confirmation prompt |

Also accepts the [global flags](https://docs.bronto.io/cli/reference/commands/global-flags.md).

#### Examples

```sh theme={"dark"}
bronto forward-configs delete <id> --yes
```

## bronto forward-configs list

List forward configs

```sh theme={"dark"}
bronto forward-configs list [flags]
```

Also accepts the [global flags](https://docs.bronto.io/cli/reference/commands/global-flags.md).

#### Examples

```sh theme={"dark"}
bronto forward-configs list
```

## bronto forward-configs test

Check that Bronto can write to a forward config's S3 destination

> [!TIP]
>
> * **Platform docs:** [docs.bronto.io/core-features/log-forwarding](https://docs.bronto.io/core-features/log-forwarding.md)
> * **API reference:** [docs.bronto.io/api-reference/forward/test-access-to-the-destination](https://docs.bronto.io/api-reference/forward/test-access-to-the-destination.md)

```sh theme={"dark"}
bronto forward-configs test [forward-config] [--bucket <bucket>] [--prefix <prefix>] [--storage-class <class>] [flags]
```

#### Flags

| Flag | Short | Type | Default | Description |
| - | - | - | - | - |
| `--bucket` | | string | | S3 bucket to test (overrides the forward config's) |
| `--prefix` | | string | | key prefix for the test object (overrides the forward config's) |
| `--storage-class` | | string | | S3 storage class: STANDARD, STANDARD\_IA or GLACIER\_IR |

Also accepts the [global flags](https://docs.bronto.io/cli/reference/commands/global-flags.md).

#### Examples

```sh theme={"dark"}
bronto forward-configs test archive
bronto forward-configs test --bucket my-archive-bucket --prefix bronto/
```

## bronto forward-configs update

Update a forward config

```sh theme={"dark"}
bronto forward-configs update <id> [flags]
```

#### Flags

| Flag | Short | Type | Default | Description |
| - | - | - | - | - |
| `--field` | `-f` | stringArray | | request body field as key=value; values parse as JSON when possible (repeatable) |
| `--input` | | string | | read the request body from a file, or - for stdin |

Also accepts the [global flags](https://docs.bronto.io/cli/reference/commands/global-flags.md).

#### Examples

```sh theme={"dark"}
bronto forward-configs update <id> -f name=<name> -f all_logs=true -f compression=GZIP \
    -f 'destination={"destination_type":"S3","bucket":"<bucket>"}'
bronto forward-configs update <id> --input body.json
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.