{"__v":0,"_id":"588f722cbcace50f0052ba3d","category":{"version":"588f722bbcace50f0052b9e1","project":"565f5fa26bafd40d0030a064","_id":"588f722bbcace50f0052b9e6","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-02-25T18:09:36.891Z","from_sync":false,"order":4,"slug":"dashboard-api","title":"Dashboard API"},"parentDoc":null,"project":"565f5fa26bafd40d0030a064","user":"565f3941ea46251700972783","version":{"__v":1,"_id":"588f722bbcace50f0052b9e1","project":"565f5fa26bafd40d0030a064","createdAt":"2017-01-30T17:04:43.410Z","releaseDate":"2017-01-30T17:04:43.410Z","categories":["588f722bbcace50f0052b9e2","588f722bbcace50f0052b9e3","588f722bbcace50f0052b9e4","588f722bbcace50f0052b9e5","588f722bbcace50f0052b9e6","588f722bbcace50f0052b9e7"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"5.3.0","version":"5.3.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-19T18:09:04.177Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"curl","code":"curl -b cookies.txt -c cookies.txt -H \"Content-Type: application/json\" -X PUT -d '{\"host\":{\"name\":\"localhost development\",\"hostname\":\"dev.localhost\"}}' \"https://api.nanoscale.io/apis/95/hosts/87\""}]},"method":"put","results":{"codes":[{"name":"","code":"{\n    \"host\": {\n        \"api_id\": 95,\n        \"id\": 87,\n        \"name\": \"localhost development\",\n        \"hostname\": \"dev.localhost\"\n    }\n}","language":"json","status":200}]},"settings":"","auth":"required","params":[{"_id":"56c75c59862f940d0056478d","ref":"","in":"path","required":true,"desc":"The host's id","default":"","type":"string","name":"id"}],"url":"/hosts/:id"},"isReference":true,"order":33,"body":"Updates a single host.\n\nHere is a list of fields that can be provided.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"key\",\n    \"h-1\": \"type\",\n    \"h-2\": \"description\",\n    \"0-0\": \"name\",\n    \"1-0\": \"hostname\",\n    \"0-1\": \"`string`\",\n    \"1-1\": \"`string`\",\n    \"0-2\": \"The name of the host (internally for nanoscale.io).\",\n    \"1-2\": \"The host name or ip address of the server.\"\n  },\n  \"cols\": 3,\n  \"rows\": 2\n}\n[/block]\nHere is an example of the `JSON` used to update a host:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"host\\\": {\\n        \\\"name\\\": \\\"localhost development\\\",\\n        \\\"hostname\\\": \\\"dev.localhost\\\"\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"hostsid-1","type":"endpoint","title":"/hosts/:id"}

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
string
The host's id

Examples


Result Format


Documentation

Updates a single host. Here is a list of fields that can be provided. [block:parameters] { "data": { "h-0": "key", "h-1": "type", "h-2": "description", "0-0": "name", "1-0": "hostname", "0-1": "`string`", "1-1": "`string`", "0-2": "The name of the host (internally for nanoscale.io).", "1-2": "The host name or ip address of the server." }, "cols": 3, "rows": 2 } [/block] Here is an example of the `JSON` used to update a host: [block:code] { "codes": [ { "code": "{\n \"host\": {\n \"name\": \"localhost development\",\n \"hostname\": \"dev.localhost\"\n }\n}", "language": "json" } ] } [/block]