---
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.

## Changes

- **2026-04-28** `b460fd7a0e4e` — 1 info
  - added the new optional request property `connection_timeout`
- **2026-04-28** `7ca1e345dc2c` — 1 info
  - added the optional property `settings/connection_timeout` to the response with the `201` status
- **2026-03-31** `e3675d1259b1` — 5 info
  - added the new optional request property `concurrent_builds`
  - added the new optional request property `deployment_queue_limit`
  - added the new optional request property `dynamic_timeout`
  - added the new optional request property `server_disk_usage_check_frequency`
  - …1 more
- **2026-03-16** `385ee693a76d` — 7 warning
  - removed the request property `concurrent_builds`
  - removed the request property `connection_timeout`
  - removed the request property `deployment_queue_limit`
  - removed the request property `dynamic_timeout`
  - …3 more

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/servers/:uuid/patch.md)

---

[API](https://skmtc.dev/coollabsio/apis/coolify.md) · [All operations](https://skmtc.dev/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coollabsio/coolify/revisions/789e6ad3796c/schema)