Update a dedicated server
A PUT request to /v1/hosts/dedicated_servers/{server_id} updates a dedicated server chosen in the path parameter. Labels can be assigned in the request body.
Authorization
bearerAuth In: header
Path Parameters
| Field | Details |
|---|---|
server_id | stringA unique identifier of a dedicated server. |
Request Body
| Field | Details |
|---|---|
labels? | objectSpecify labels you want to attach to the resource. Refer to the Labels section for more details. |
title? | stringThis parameter updates a title of the selected server in the Servers.com systems without naming changes inside an operating system. |
user_data? | stringUser data is the content that will be processed by cloud-init during server's initialization. Paste your file's content in this argument. The first line is significant because it defines a type of data. We recommend you get acquainted with available formats in the cloud-init documentation. User data is available for Linux via cloud-init and for Windows via cloudbase-init. User data formats for cloudbase-init. |
ipxe_config? | stringA parameter to pass the content of an iPXE script as a string. Learn more in the iPXE Boot section. |
Response Body
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/hosts/dedicated_servers/BDbDqBdl" \ -H "Content-Type: application/json" \ -d '{ "labels": { "environment": "production", "service": "my-web-app", "example.com/project": "my-project", "example.com/owner": "second-team" }, "title": "my-production-server", "user_data": "#cloud-init" }'{ "id": "BDbDqBdl", "rack_id": "46dBrxd7", "title": "my-production-server", "location_id": 535, "location_code": "location1099", "status": "active", "operational_status": "normal", "power_status": "powered_on", "configuration": "REMM R123", "private_ipv4_address": "10.0.0.70", "public_ipv4_address": "169.254.0.70", "lease_start_at": "2025-12-29", "scheduled_release_at": null, "type": "dedicated_server", "oob_ipv4_address": "198.29.114.3", "configuration_details": { "ram_size": 0, "server_model_id": null, "server_model_name": null, "bandwidth_id": null, "bandwidth_name": null, "private_uplink_id": null, "private_uplink_name": null, "public_uplink_id": null, "public_uplink_name": null, "operating_system_id": null, "operating_system_full_name": null }, "labels": { "environment": "production", "service": "my-web-app", "example.com/project": "my-project", "example.com/owner": "second-team" }, "ipxe_config": null, "userdata_sha256": "81356ce685aa498e42c1978001ef2bc184514a3bca7afb05124d9ffad68e8f5d", "created_at": "2025-12-31T00:00:00Z", "updated_at": "2025-12-31T00:00:00Z", "rack_units_from": 10, "rack_units_to": 12, "rack_units_count": 3}