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

# Create bucket

> Create a new bucket to organize streams.

<ParamField path="bucket" type="string" required>
  Bucket ID. Must match `[a-z0-9_-]{4,64}`.
</ParamField>

## Response

| Status | Meaning                      |
| ------ | ---------------------------- |
| `201`  | Bucket created successfully. |
| `400`  | Invalid bucket ID.           |
| `409`  | Bucket already exists.       |

<RequestExample>
  ```bash Example theme={null}
  curl -X PUT https://stream.tonbo.dev/ds/demo
  ```
</RequestExample>

<Note>
  Write requests are automatically forwarded to the cluster leader. If the current node is not the leader, you will receive a `307` redirect with a `Location` header pointing to the leader.
</Note>