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.

PATCH
/applications/{uuid}/storages

Update a persistent storage or file storage by application UUID.

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

UUID of the application.

Request Body

application/json

Storage updated. For read-only storages (from docker-compose or services), only is_preview_suffix_enabled can be updated.

TypeScript Definitions

Use the request body type in TypeScript.

uuid?string

The UUID of the storage (preferred).

id?integer

The ID of the storage (deprecated, use uuid instead).

type*string

The type of storage: persistent or file.

Value in"persistent" | "file"
is_preview_suffix_enabled?boolean

Whether to add -pr-N suffix for preview deployments.

name?string

The volume name (persistent only, not allowed for read-only storages).

mount_path?string

The container mount path (not allowed for read-only storages).

host_path?string

The host path (persistent only, not allowed for read-only storages).

content?string

The file content (file only, not allowed for read-only storages).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://app.coolify.io/api/v1/applications/string/storages" \  -H "Content-Type: application/json" \  -d '{    "type": "persistent"  }'
{}
{  "message": "Invalid token."}
{  "message": "Unauthenticated."}
{  "message": "Resource not found."}
{  "message": "Validation error.",  "errors": {    "name": [      "The name field is required."    ],    "api_url": [      "The api url field is required.",      "The api url format is invalid."    ]  }}

Update Envs (Bulk) PATCH

Update multiple envs by application UUID.

Create Cloud-init Script POST

Create a new cloud-init script for the authenticated team.