Coolify logoCoolify
PATCH
/services/{uuid}

Update service by 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 service.

Request Body

application/json

Service updated.

TypeScript Definitions

Use the request body type in TypeScript.

name?string

The service name.

description?string

The service description.

project_uuid?string

The project UUID.

environment_name?string

The environment name.

environment_uuid?string

The environment UUID.

server_uuid?string

The server UUID.

destination_uuid?string

The destination UUID.

instant_deploy?boolean

The flag to indicate if the service should be deployed instantly.

connect_to_docker_network?boolean

Connect the service to the predefined docker network.

Defaultfalse
docker_compose_raw?string

The base64 encoded Docker Compose content.

urls?array<>

Array of URLs to be applied to containers of a service.

force_domain_override?boolean

Force domain override even if conflicts are detected.

Defaultfalse

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://app.coolify.io/api/v1/services/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "uuid": "string",  "domains": [    "string"  ]}
{  "message": "Invalid token."}
{  "message": "Unauthenticated."}
{  "message": "Resource not found."}
{  "message": "Domain conflicts detected. Use force_domain_override=true to proceed.",  "warning": "Using the same domain for multiple resources can cause routing conflicts and unpredictable behavior.",  "conflicts": [    {      "domain": "example.com",      "resource_name": "My Application",      "resource_uuid": "abc123-def456",      "resource_type": "application",      "message": "Domain example.com is already in use by application 'My Application'"    }  ]}
{  "message": "Validation error.",  "errors": {    "name": [      "The name field is required."    ],    "api_url": [      "The api url field is required.",      "The api url format is invalid."    ]  }}