# pier objects

> Bucket objects (data plane)

URL: https://pier.run/docs/cli/reference/objects

```bash
pier objects <command>
```

Bucket objects (data plane).

## Subcommands

### pier objects put

```bash
pier objects put [flags]
```

Upload a file to a bucket.

| Flag             | Value    | Default | Description                              |
| ---------------- | -------- | ------- | ---------------------------------------- |
| `-b`, `--bucket` | `STRING` |         | Bucket name, slug, or ID                 |
| `-f`, `--file`   | `STRING` |         | Local file path to upload                |
| `--key`          | `STRING` |         | Remote object key (defaults to filename) |

### pier objects get

```bash
pier objects get [<key>] [flags]
```

Download an object from a bucket.

| Argument | Required | Description |
| -------- | -------- | ----------- |
| `<key>`  | no       | Object key  |

| Flag             | Value    | Default | Description                                 |
| ---------------- | -------- | ------- | ------------------------------------------- |
| `-b`, `--bucket` | `STRING` |         | Bucket name, slug, or ID                    |
| `-o`, `--output` | `STRING` |         | Local file path (defaults to key basename)  |
| `--prefix`       | `STRING` |         | Filter the interactive picker by key prefix |

### pier objects ls

```bash
pier objects ls [flags]
```

List objects in a bucket.

| Flag             | Value    | Default | Description                  |
| ---------------- | -------- | ------- | ---------------------------- |
| `-b`, `--bucket` | `STRING` |         | Bucket name, slug, or ID     |
| `--prefix`       | `STRING` |         | Filter objects by key prefix |
| `--max-keys`     | `100`    | `100`   | Max objects to return        |

### pier objects rm

```bash
pier objects rm [<key>] [flags]
```

Remove an object from a bucket.

| Argument | Required | Description |
| -------- | -------- | ----------- |
| `<key>`  | no       | Object key  |

| Flag             | Value    | Default | Description                                 |
| ---------------- | -------- | ------- | ------------------------------------------- |
| `-b`, `--bucket` | `STRING` |         | Bucket name, slug, or ID                    |
| `-y`, `--yes`    |          |         | Skip confirmation prompt                    |
| `--prefix`       | `STRING` |         | Filter the interactive picker by key prefix |

### pier objects presign

```bash
pier objects presign [<key>] [flags]
```

Generate a presigned URL for an object.

| Argument | Required | Description |
| -------- | -------- | ----------- |
| `<key>`  | no       | Object key  |

| Flag             | Value    | Default | Description                                                       |
| ---------------- | -------- | ------- | ----------------------------------------------------------------- |
| `-b`, `--bucket` | `STRING` |         | Bucket name, slug, or ID                                          |
| `--method`       | `STRING` |         | HTTP method: GET or PUT (defaults to GET in non-interactive mode) |
| `--prefix`       | `STRING` |         | Filter the interactive picker by key prefix (GET only)            |

[Global flags](/docs/cli/reference#global-flags) apply to every command.