# S3

URL: https://docs.hanzo.ai/docs/cli/s3

> The `hanzo s3` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/s3) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/s3) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Object storage: your buckets and the files in them, with signed URLs for upload and download.

[API reference →](https://docs.hanzo.ai/docs/openapi/s3)

```bash
hanzo s3 buckets list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command           | What it does                                              |
| ----------------- | --------------------------------------------------------- |
| `hanzo s3 health` | Reports whether this deployment can serve object storage. |

### Buckets

| Command                                    | What it does                                                     |
| ------------------------------------------ | ---------------------------------------------------------------- |
| `hanzo s3 buckets create`                  | Makes a new bucket for the caller's org and answers 201 with it. |
| `hanzo s3 buckets list`                    | Lists the caller org's own buckets.                              |
| `hanzo s3 buckets objects create <bucket>` | Mints a presigned PUT URL the caller uploads to DIRECTLY.        |
| `hanzo s3 buckets objects get <bucket>`    | Lists one folder level of a bucket.                              |
| `hanzo s3 buckets rm <bucket>`             | Removes an EMPTY bucket and answers 204.                         |