Coolify logoCoolify
Cloud

API server

https://app.coolify.io/api/v1

Choose where to send API requests

This changes the request URL and code examples on every endpoint page.

API server type

Requests will use

https://app.coolify.io/api/v1

Use only a Coolify URL you trust. Sending a test request also sends the API token you enter.

POST
/s3-storages

Create a new S3 storage configuration for the authenticated team.

Authorization

bearerAuth
AuthorizationBearer <token>

Go to Keys & Tokens / API tokens and create a new token. Use the token as the bearer token.

In: header

Request Body

application/json

S3 storage details

TypeScript Definitions

Use the request body type in TypeScript.

name*string

A friendly name for the storage.

description?string

Optional description.

endpoint*string

S3-compatible endpoint URL.

bucket*string

S3 bucket name.

region*string

S3 region.

key*string

Access key.

secret*string

Secret key.

is_usable?boolean

Whether the storage is marked usable.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://app.coolify.io/api/v1/s3-storages" \  -H "Content-Type: application/json" \  -d '{    "name": "My S3 Storage",    "endpoint": "https://s3.us-east-1.amazonaws.com",    "bucket": "my-bucket",    "region": "us-east-1",    "key": "string",    "secret": "string"  }'
{  "uuid": "og888os"}
{  "message": "Invalid token."}
{  "message": "Unauthenticated."}
{  "message": "Validation error.",  "errors": {    "name": [      "The name field is required."    ],    "api_url": [      "The api url field is required.",      "The api url format is invalid."    ]  }}

List GET

Get all resources.

Delete S3 Storage DELETE

Delete S3 storage by UUID.