If a Host already exists with the specified HostID, an HTTP 303 See Other status will be returned with a Location header pointing to the existing Host object's API path.

In future versions, the successful return status may be changed to 201response with a Location: header of the newly-created object's URL.

If the HTTP Body is invalid JSON, the Body is empty, or Content-Type is not specified or specified as a different MIME type, then an HTTP 415 Unsupported Media Type status response will be returned.

If the HTTP Body fails data validation (e.g. does not include a name or target), an HTTP 422 Unprocessable Content status response will be returned. No explicit/static error is defined for this condition, as the output will vary depending on what actual validation failed. It will, however, always be in the form of {"error": "<error message>"}.

204204

303303

415415

422422