---
title: "Update"
method: PATCH
path: "/servers/{uuid}"
tags: ["Servers"]
---

# Update

`PATCH /servers/{uuid}`

Update Server.

## Path parameters

- `uuid` string, required

## Request body

- object
  - `name` string — The name of the server.
  - `description` string — The description of the server.
  - `ip` string — The IP of the server.
  - `port` integer — The port of the server.
  - `user` string — The user of the server.
  - `private_key_uuid` string — The UUID of the private key.
  - `is_build_server` boolean — Is build server.
  - `instant_validate` boolean — Instant validate.
  - `proxy_type` 'traefik' | 'caddy' | 'none' — The proxy type.
  - `concurrent_builds` integer — Number of concurrent builds.
  - `dynamic_timeout` integer — Deployment timeout in seconds.
  - `deployment_queue_limit` integer — Maximum number of queued deployments.
  - `server_disk_usage_notification_threshold` integer — Server disk usage notification threshold (%).
  - `server_disk_usage_check_frequency` string — Cron expression for disk usage check frequency.
  - `connection_timeout` integer — SSH connection timeout in seconds (1-300). Default: 10.

## Response `201`

Server updated.

- Server — Server model
  - `id` integer — The server ID.
  - `uuid` string — The server UUID.
  - `name` string — The server name.
  - `description` string — The server description.
  - `ip` string — The IP address.
  - `user` string — The user.
  - `port` integer — The port number.
  - `proxy` object — The proxy configuration.
  - `proxy_type` 'traefik' | 'caddy' | 'none' — The proxy type.
  - `high_disk_usage_notification_sent` boolean — The flag to indicate if the high disk usage notification has been sent.
  - `unreachable_notification_sent` boolean — The flag to indicate if the unreachable notification has been sent.
  - `unreachable_count` integer — The unreachable count for your server.
  - `validation_logs` string — The validation logs.
  - `log_drain_notification_sent` boolean — The flag to indicate if the log drain notification has been sent.
  - `swarm_cluster` string — The swarm cluster configuration.
  - `settings` ServerSetting — Server Settings model
    - `id` integer
    - `concurrent_builds` integer
    - `deployment_queue_limit` integer
    - `dynamic_timeout` integer
    - `force_disabled` boolean
    - `force_server_cleanup` boolean
    - `is_build_server` boolean
    - `is_cloudflare_tunnel` boolean
    - `is_jump_server` boolean
    - `is_logdrain_axiom_enabled` boolean
    - `is_logdrain_custom_enabled` boolean
    - `is_logdrain_highlight_enabled` boolean
    - `is_logdrain_newrelic_enabled` boolean
    - `is_metrics_enabled` boolean
    - `is_reachable` boolean
    - `is_sentinel_enabled` boolean
    - `is_swarm_manager` boolean
    - `is_swarm_worker` boolean
    - `is_terminal_enabled` boolean
    - `is_usable` boolean
    - `logdrain_axiom_api_key` string
    - `logdrain_axiom_dataset_name` string
    - `logdrain_custom_config` string
    - `logdrain_custom_config_parser` string
    - `logdrain_highlight_project_id` string
    - `logdrain_newrelic_base_uri` string
    - `logdrain_newrelic_license_key` string
    - `sentinel_metrics_history_days` integer
    - `sentinel_metrics_refresh_rate_seconds` integer
    - `sentinel_token` string
    - `docker_cleanup_frequency` string
    - `docker_cleanup_threshold` integer
    - `server_id` integer
    - `wildcard_domain` string
    - `created_at` string
    - `updated_at` string
    - `delete_unused_volumes` boolean — The flag to indicate if the unused volumes should be deleted.
    - `delete_unused_networks` boolean — The flag to indicate if the unused networks should be deleted.
    - `connection_timeout` integer — SSH connection timeout in seconds.

## Other responses

- `400` — Invalid token.
- `401` — Unauthenticated.
- `404` — Resource not found.
- `422` — Validation error.

---

[API](https://skmtc.net/coollabsio/apis/coolify.md) · [All operations](https://skmtc.net/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coollabsio/coolify/versions/08be5dc8e729/schema)