Validate S3 Storage

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/{uuid}/validate

Validate a storage connection. S3: lists the bucket (ListObjectsV2). SFTP, FTPS, and WebDAV: lists the backup directory; for SFTP, the first successful validation pins the host key of the server.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

uuid*string

S3 Storage UUID

Response Body

application/json

application/json

application/json

curl -X POST "https://app.coolify.io/api/v1/s3-storages/string/validate"
{  "valid": true,  "message": "S3 storage connection is valid."}
{  "message": "Unauthenticated."}
{  "message": "Resource not found."}