Cycle Docs | API Reference | Delete a Server

Delete a Server

Creates a task that deletes the specified server. You cannot delete a server that has instances on it. Please delete all instances running on the server before attempting to delete.

Requires the servers-decommission permission.

Returns

Returns a Task Descriptor Object, otherwise returns an Error.

DELETE /v1/infrastructure/servers/{ID}

Example Request

$ curl https://api.cycle.io/v1/infrastructure/servers/5dd333ee4146380001d9e3b5 \
  -H "Authorization: Bearer API_KEY"
 \
  -H "X-Hub-Id: HUB_ID"
 \
  -X DELETE

Example Response

{
  "data": {
    "action": "delete",
    "job_id": "5d01b9b3db2ab00001508cd8"
  }
}