Servers

Create bare metal service

POST/v1/baremetal

Orders an hourly-billed baremetal service and returns the new service; a replayed Idempotency-Key answers 200 with the service it created.

curl --request POST \
  --url https://api.serverside.com/v1/baremetal \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "plan": "<string>",
  "datacenter": "<string>",
  "ipv4PrefixLength": 30,
  "ipv6PrefixLength": 120,
  "name": "<string>",
  "bootMode": "LOCAL_DISK",
  "ipxeScript": "<string>"
}
'

{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2026-01-15T09:30:00Z",
    "isLocked": true,
    "isSuspended": true,
    "state": "ACTIVE",
    "primaryIpv4": "<string>",
    "primaryIpv6": "<string>",
    "bandwidth": {
      "includedEgressGb": 123
    },
    "region": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "code": "<string>",
      "name": "<string>",
      "city": "<string>",
      "state": "<string>",
      "countryCode": "<string>",
      "facility": "<string>",
      "rack": "<string>"
    },
    "hardware": {
      "assetId": "<string>",
      "cpuManufacturer": "INTEL",
      "cpuModel": "<string>",
      "cpuCores": 123,
      "cpuClockMhz": 123,
      "memoryGb": 123,
      "drives": [
        {
          "model": "<string>",
          "sizeBytes": 123,
          "serial": "<string>",
          "type": "UNKNOWN"
        }
      ],
      "capabilities": [
        "KVM"
      ]
    },
    "interfaces": [
      {
        "segmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "bondMode": "LACP",
        "physicalInterfaces": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "macAddress": "<string>",
            "speedMbps": 123,
            "segmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
          }
        ],
        "networks": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "type": "PRIVATE",
            "managedBy": "CUSTOMER",
            "localVlanId": 123,
            "provisioningVlanId": 123,
            "isNative": true,
            "prefixes": [
              {
                "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                "createdAt": "2026-01-15T09:30:00Z",
                "cidr": "<string>",
                "gateway": "<string>",
                "subnetMask": "<string>",
                "prefixLength": 123,
                "addresses": [
                  "<string>"
                ]
              }
            ]
          }
        ]
      }
    ],
    "operatingSystem": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "slug": "<string>",
      "name": "<string>",
      "deployedAt": "2026-01-15T09:30:00Z",
      "username": "<string>"
    },
    "operation": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "DEPLOYMENT",
      "progress": 123,
      "startedAt": "2026-01-15T09:30:00Z",
      "lastProgressAt": "2026-01-15T09:30:00Z",
      "lastProgressMessage": "<string>"
    },
    "bootMode": "LOCAL_DISK",
    "lastOperation": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "DEPLOYMENT",
      "progress": 123,
      "startedAt": "2026-01-15T09:30:00Z",
      "lastProgressAt": "2026-01-15T09:30:00Z",
      "lastProgressMessage": "<string>",
      "state": "CREATED",
      "endedAt": "2026-01-15T09:30:00Z",
      "failureCategory": "<string>"
    }
  }
}

Authorizations

Authorizationstringheaderrequired
Organization API key (org_...), created in the cloud console at https://cloud.serverside.com and shown once, sent as Authorization: Bearer <key>. It authenticates as the organization.

Required permission: organization.billing.orders.create

Headers

Idempotency-Keystring
Limits:length <= 200

Body

application/json

planstringrequired
Limits:length >= 1
datacenterstringrequired
Limits:length >= 1
ipv4PrefixLengthinteger<int32> | null
Limits:24 <= x <= 30
Default:30
ipv6PrefixLengthinteger<int32> | null
Default:120
namestring | null
Limits:length 2 to 64
bootModeenum<string>
Allowed values:LOCAL_DISKPXE
ipxeScriptstring | null
Limits:length <= 65536

Response

200 · application/json

successbooleanrequired
Allowed values:true
dataobject | nullrequired

Authorizations

Headers

Body

Response

Footer