---
title: "Create S3 Storage"
method: POST
path: "/s3-storages"
tags: ["S3 Storages"]
---

# Create S3 Storage

`POST /s3-storages`

Create a new S3 storage configuration for the authenticated team.

## Request body

- object
  - `name` string, required — A friendly name for the storage.
  - `description` string, nullable — Optional description.
  - `endpoint` string, required — S3-compatible endpoint URL.
  - `bucket` string, required — S3 bucket name.
  - `region` string, required — S3 region.
  - `key` string, required — Access key.
  - `secret` string, required — Secret key.
  - `is_usable` boolean — Whether the storage is marked usable.

## Response `201`

S3 storage created.

- object
  - `uuid` string — The UUID of the S3 storage.

## Other responses

- `400` — Invalid token.
- `401` — Unauthenticated.
- `422` — Validation error.

---

[API](https://skmtc.net/coollabsio/apis/coolify.md) · [All operations](https://skmtc.net/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coollabsio/coolify/revisions/789e6ad3796c/schema)