---
title: "Create Bucket"
method: POST
path: "/api/v1/buckets"
tags: ["Bucket"]
---

# Create Bucket

`POST /api/v1/buckets`

creates a new bucket on an object storage

## Request body

- CreateBucket
  - `name` string
  - `plan` string
  - `permission` string

## Response `201`

successful operation

- object
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Missing authentication
- `409` — Conflict
- `500` — server does not response

## Changes

- **2023-10-06** `e80fa6480d76` — 1 breaking, 2 info
  - removed the media type `*/*` from the request body
  - added the media type `application/json` to the request body
  - added the media type `application/json` for the response with the status `201`
- **2023-10-04** `aa2c8187a376` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/liara-cloud/apis/object-storage-api-documentaion/changes/api/v1/buckets/post.md)

---

[API](https://skmtc.dev/liara-cloud/apis/object-storage-api-documentaion.md) · [All operations](https://skmtc.dev/liara-cloud/apis/object-storage-api-documentaion/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liara-cloud/object-storage-api-documentaion/revisions/b0ca12d806de/schema)