Coolify logoCoolify
Cloud

Delete

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.

DELETE
/services/{uuid}

Delete service by UUID. Needs a token with the write and deploy permissions.

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

Service UUID

Query Parameters

delete_configurations?boolean

Delete configurations.

Defaulttrue
delete_volumes?boolean

Delete volumes.

Defaulttrue
docker_cleanup?boolean

Run docker cleanup when the server disk usage is at or above its cleanup threshold. Skipped when a cleanup ran on the server in the last hour.

Defaulttrue
delete_connected_networks?boolean

Delete connected networks.

Defaulttrue

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://app.coolify.io/api/v1/services/string"
{  "message": "Service deletion request queued."}
{  "message": "Invalid token."}
{  "message": "Unauthenticated."}
Empty
{  "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."    ]  }}

Delete Env DELETE

Delete env by UUID.

Delete service storage backup schedule DELETE

Delete the backup schedule and its local and S3 archives for a service storage.