Coolify logoCoolify
Cloud

Release Service DNS Record

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}/dns/{hostname}

Release the managed DNS record of a hostname that the service no longer uses. Coolify deletes the record at Cloudflare only when it created the record, the record did not change, and no other resource uses the hostname. Removing a domain through the API already queues this release; use this endpoint to retry it or to keep the record.

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.

hostname*string

Hostname of the record.

Query Parameters

delete_record?boolean

Delete the record at Cloudflare. Default: true.

Response Body

application/json

application/json

curl -X DELETE "https://app.coolify.io/api/v1/services/string/dns/string"
{  "result": "deleted",  "message": "string"}
{  "message": "Unauthenticated."}
Empty
Empty
Empty
Empty
Empty

Release Application DNS Record DELETE

Release the managed DNS record of a hostname that the application no longer uses. Coolify deletes the record at Cloudflare only when it created the record, the record did not change, and no other resource uses the hostname. Removing a domain through the API already queues this release; use this endpoint to retry it or to keep the record.

Replace Application DNS Record POST

Point the conflicting record from a 409 create response to the server of the application.