Maxihost Developer Hub

Maxihost Developer Hub

Welcome to Maxihost's Developer Hub. Here you'll find comprehensive guides and documentation to help you start working with Maxihost as quickly as possible, as well as support if yo u get stuck. Let's jump right in!

Guides
Suggest Edits

Welcome

 

Welcome to our API documentation! You can view code examples in the area to the right.

For more information about Maxihost products, you can visit our product documentation.

Suggest Edits

API Summary

 

JSON is returned in all responses.

The API also uses common approaches for the following:

Function
Description

Data

API data is JSON encoded with UTF-8. API JSON is either a single object or a list of objects.

Authorization

Access control using API Access Tokens.

Errors

4xx and 5xx responses returning JSON with error codes

HTTP

Methods are used in accordance with HTTP (GET POST and DELETE are the primary methods used) and resources are identified using URIs. All API requests are sent over HTTPS.

Suggest Edits

Access Tokens

 

You'll need an Access Token if you want to use the API to access your own Maxihost data – for example, if you use the API with your own scripts to get data from your Maxihost account.

Setting up Access Tokens

Access Tokens should never be shared outside of your company

Access Tokens allow access to your private customer data in Maxihost. They should not be shared outside of your company. We cannot stress enough how important it is for you not to share your Token with anyone.

Creating your Access Token is simple and you can get a Token instantly.

To create your Access Token, go to the API page on the dashboard by clicking here or by clicking on API on the main menu.

Using your Access Token

Once you have created your Access Token you will see it in the same section of your Dashboard. You can edit or delete the token from here.

You can copy your token and use it in much the same way as you would use an API Key. The specifics will depend on how you are integrating with Maxihost.

To use your Access Token simply provide it as part of the authorization header when you make a request. Access Tokens use the bearer authorization header when you make a request. This just means you need to specify the bearer type in the header.

For more info on the bearer token framework please see the official spec.

$ curl \
-s https://api.maxihost.com/users/494817923 \
-H "Authorization: Bearer <access_token>" \
-H 'Accept:application/json'
Suggest Edits

Versioning

 

In order to use version 1.1, all you have to do is send the following header on your request:

Accept: application/vnd.maxihost.v1.1+json

Suggest Edits

Custom Scripts

 
Suggest Edits

Create Custom Script

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.maxihost.com/devices/custom_scripts
curl --request POST \
  --url https://api.maxihost.com/devices/custom_scripts
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.maxihost.com/devices/custom_scripts' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/custom_scripts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.maxihost.com/devices/custom_scripts");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/custom_scripts"

response = requests.request("POST", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 3,
  "name": "01-my-custom-script",
  "content": "#cloud-config"
}
{
  "status": false,
  "code": "CUSTOM_SCRIPT_NAME_INVALID",
  "error_messages": {
    "name": [
      ""
    ]
  }
}

Body Params

name
string
required

A name to identify the script

content
string
required

The script content

Response

Custom Script created

idinteger
contentstring
namestring

Invalid Custom Script

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

List Custom Scripts Names

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/devices/custom_scripts
curl --request GET \
  --url https://api.maxihost.com/devices/custom_scripts
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.maxihost.com/devices/custom_scripts' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/custom_scripts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/devices/custom_scripts");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/custom_scripts"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "custom_scripts": [
    {
      "id": 1,
      "name": "01-my-custom-script",
      "content": "#cloud-config"
    }
  ],
  "links": {
    "self": "https://api.maxihost.com/devices/custom_scripts?limit=1&page=1"
  },
  "meta": {
    "pages": {
      "total": 1,
      "count": 1
    }
  }
}

Query Params

page
string

The page number.

limit
string

The page size.

Response

List Custom Scripts

custom_scriptsarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

Show Custom Script

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/devices/custom_scripts/id
curl --request GET \
  --url https://api.maxihost.com/devices/custom_scripts/id
var request = require("request");

var options = { method: 'GET',
  url:
   'https://api.maxihost.com/devices/custom_scripts/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/custom_scripts/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/devices/custom_scripts/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/custom_scripts/id"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 1,
  "name": "01-my-custom-script",
  "custom_script": "#cloud-config"
}
{
  "status": false,
  "code": "CUSTOM_SCRIPT_NOT_FOUND",
  "error_messages": {
    "base": [
      "The provided id was not found."
    ]
  }
}

Path Params

id
string
required

Custom Script ID

Response

Custom Script

idinteger
namestring
contentstring

Invalid id

statusboolean
codestring
error_messagesobject
error_messages.idarray
Suggest Edits

Update Custom Script

 

Header Auth

 Authentication is required for this endpoint.
puthttps://api.maxihost.com/devices/custom_scripts/id
curl --request PUT \
  --url https://api.maxihost.com/devices/custom_scripts/id
var request = require("request");

var options = { method: 'PUT',
  url:
   'https://api.maxihost.com/devices/custom_scripts/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/custom_scripts/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("PUT", "https://api.maxihost.com/devices/custom_scripts/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/custom_scripts/id"

response = requests.request("PUT", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 1,
  "name": "01-my-custom-script-updated",
  "content": "#cloud-config updated"
}
{
  "status": false,
  "code": "CUSTOM_SCRIPT_NOT_FOUND",
  "error_messages": {
    "base": [
      "The provided id was not found."
    ]
  }
}
{
  "status": false,
  "code": "UNPROCESSABLE_ENTITY",
  "error_messages": {
    "base": [
      "Name can't be blank"
    ]
  }
}

Path Params

id
string
required

Custom Script ID

Body Params

name
string
content
string

Response

Custom Script updated

idinteger
namestring
contentstring

Invalid id

statusboolean
codestring
error_messagesobject
error_messages.idarray

Invalid name

statusboolean
error_messagesobject
error_messages.namearray
Suggest Edits

Remove Custom Script

 

Header Auth

 Authentication is required for this endpoint.
deletehttps://api.maxihost.com/devices/custom_scripts/id
curl --request DELETE \
  --url https://api.maxihost.com/devices/custom_scripts/id
var request = require("request");

var options = { method: 'DELETE',
  url:
   'https://api.maxihost.com/devices/custom_scripts/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/custom_scripts/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("DELETE", "https://api.maxihost.com/devices/custom_scripts/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/custom_scripts/id"

response = requests.request("DELETE", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{}
{
  "status": false,
  "code": "CUSTOM_SCRIPT_NOT_FOUND",
  "error_messages": {
    "base": [
      "The provided id was not found."
    ]
  }
}

Path Params

id
string
required

Custom Script ID

Response

SSH Key destroyed

Custom Script not found

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

Servers

 
Suggest Edits

Create a server

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.maxihost.com/devices
curl --request POST \
  --url https://api.maxihost.com/devices
var request = require("request");

var options = { method: 'POST', url: 'https://api.maxihost.com/devices' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.maxihost.com/devices");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices"

response = requests.request("POST", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 1338,
  "created_at": 1537286770,
  "total": 590,
  "prorated_total": 590,
  "period": "monthly",
  "service_id": 6318,
  "info": [
    {
      "hostname": "mh1-sp-db.maxihost.com"
    }
  ]
}
{
  "status": false,
  "error_messages": [
    "Plan is out of stock"
  ]
}

Body Params

facility
string
required

The slug from the region the server should be created on. You get this from the /regions endpoint.

plan
string
required

Plan's slug. You get this from the /plans endpoint.

hostname
string
required

Server hostname. Only alphanumberic, dashes and dots are allowed.

operating_system
string
required

Operating System to deploy. You get this from the /plans/operating-systems endpoint.

billing_cycle
string
required

Periodicity the server should be charged. Currently, only 'monthly' is allowed.

ssh_keys
array of strings

A list of SSH Key fingerprints or IDs for deployment. Optional

custom_scripts
array of strings

A list of Custom Scripts IDs for deployment. Optional

raid
string

Raid type to deploy. Allowed value: 0 or 1

Response

Server created

Server creation failure

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

List all servers

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/devices
curl --request GET \
  --url https://api.maxihost.com/devices
var request = require("request");

var options = { method: 'GET', url: 'https://api.maxihost.com/devices' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/devices");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "devices": [
    {
      "id": 6098,
      "description": "1F1D5M1",
      "type": "Bare Metal",
      "type_id": 1,
      "label": "BRC1234KD0",
      "service_id": 0,
      "status": "On",
      "last_event": null,
      "specs": {
        "cpu": "Dual Intel Xeon Silver 4116",
        "disk": "2 x 1000GB NVMe",
        "ram": "256GB"
      },
      "location": {
        "facility_name": "Maxihost SP1",
        "facility_code": "MH1",
        "row_name": "C",
        "rack_name": "01",
        "rack_position": "33"
      },
      "operating_system": {
        "name": "Ubuntu (16.04 x64 LTS)",
        "slug": "ubuntu_16_04_x64_lts"
      },
      "ips": [
        {
          "id": 6098,
          "ip_address": "1.1.1.1",
          "ip_description": "Public IPv4",
          "device_id": 613,
          "device_description": "BRC55378N7",
          "device_label": "BRC55378N7",
          "service_id": 0,
          "created_at": 1526918369,
          "updated_at": 1537818767
        }
      ]
    }
  ],
  "links": {
    "first": "https://api.maxihost.com/devices?limit=1&page=1",
    "last": "https://api.maxihost.com/devices?limit=1&page=10",
    "next": "https://api.maxihost.com/devices?limit=1&page=3",
    "prev": "https://api.maxihost.com/devices?limit=1&page=1",
    "self": "https://api.maxihost.com/devices?limit=1&page=2"
  },
  "meta": {
    "pages": {
      "count": 1,
      "total": 10
    }
  }
}

Query Params

page
string

The page number.

limit
string

Use this to limit the size of the response. E.g. for limit=10, only 10 servers would be returned.

status[]
array of strings

Optional device status filter

Response

Servers listed

devicesarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

Retrieve a server

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/devices/id
curl --request GET \
  --url https://api.maxihost.com/devices/id
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.maxihost.com/devices/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/devices/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/id"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 613,
  "description": "2PY11Y1",
  "type": "Bare Metal",
  "type_id": 1,
  "label": "2PY11Y1",
  "service_id": 0,
  "status": "On",
  "last_event": null,
  "specs": {
    "cpu": "Intel Xeon E3-1240v2",
    "disk": "500GB SATA",
    "ram": "32GB"
  },
  "location": {
    "facility_name": "Maxihost SP1",
    "facility_code": "MH1",
    "facility_country": "BR",
    "row_name": "C",
    "rack_name": "05",
    "rack_position": "33"
  },
  "operating_system": {
    "name": "CentOS (6.9 x64)",
    "slug": "centos_6_9_x64"
  },
  "ips": [
    {
      "id": 5260,
      "ip_address": "177.54.158.95",
      "ip_description": "Public IPv4",
      "device_id": 613,
      "device_description": "BRC55378N7",
      "device_label": "BRC55378N7",
      "service_id": 0,
      "created_at": 1526928304,
      "updated_at": 1537818788
    }
  ]
}
{
  "status": false,
  "code": "DEVICE_NOT_FOUND",
  "error_messages": {
    "base": [
      "Device not found."
    ]
  }
}

Path Params

id
string
required

Response

Device found

devicesarray

Server not found

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

Delete a server

 

Header Auth

 Authentication is required for this endpoint.
deletehttps://api.maxihost.com/devices/id
curl --request DELETE \
  --url https://api.maxihost.com/devices/id
var request = require("request");

var options = { method: 'DELETE',
  url: 'https://api.maxihost.com/devices/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("DELETE", "https://api.maxihost.com/devices/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/id"

response = requests.request("DELETE", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "status": false,
  "code": "DEVICE_NOT_FOUND",
  "error_messages": {
    "base": [
      "Device not found."
    ]
  }
}
{
  "status": false,
  "code": "DEVICE_NOT_FOUND",
  "error_messages": {
    "base": [
      "request failed: Device not found"
    ]
  }
}

Path Params

id
string
required

Response

Device deleted

Server not found

statusboolean
codestring
error_messagesobject
error_messages.basearray

Device not found

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

Retrieve bandwidth for a server

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/devices/id/bandwidth
curl --request GET \
  --url https://api.maxihost.com/devices/id/bandwidth
var request = require("request");

var options = { method: 'GET',
  url:
   'https://api.maxihost.com/devices/id/bandwidth' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/id/bandwidth")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/devices/id/bandwidth");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/id/bandwidth"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "bandwidth": {
    "from": 1574121750,
    "to": 1574812350,
    "duration": 690600,
    "step": 300,
    "in_traffic": {
      "max_bits_per_second": 19299.0990421768,
      "transfer_bytes": 259966601021.75662,
      "transfer_bits_per_second": 3011486.8348885793,
      "points": [
        1004.276725968,
        2004.276725968
      ],
      "current_bits_per_second": 18053.4100185312
    },
    "out_traffic": {
      "max_bits_per_second": 9972.1202914376,
      "transfer_bytes": 556009328658.7278,
      "transfer_bits_per_second": 6440884.201085755,
      "points": [
        1004.276725968,
        2004.276725968
      ],
      "current_bits_per_second": 8604.2468525416
    }
  }
}
{
  "status": false,
  "code": "NOT_FOUND",
  "error_messages": {
    "base": [
      "device especificado invC!lido"
    ]
  }
}

Path Params

id
string
required

Query Params

period
string

Period to fetch the bandwidth graph. Available: custom, week,month,yesterday,current,previous

start_time
string

Only used if period is custom. Timestamp of initial graph date.

end_time
string

Only used if period is custom. Timestamp of end graph date.

output_format
string

Output format for bandwidth data. Available: json, csv, image. Default: image

Response

Periodic device bandwidth graph

bandwidthobject
bandwidth.fromnumber
bandwidth.tonumber
bandwidth.durationnumber
bandwidth.stepnumber
bandwidth.in_trafficobject
bandwidth.in_traffic.max_bits_per_secondnumber
bandwidth.in_traffic.transfer_bytesnumber
bandwidth.in_traffic.transfer_bits_per_secondnumber
bandwidth.in_traffic.current_bits_per_secondnumber
bandwidth.in_traffic.pointsarray
bandwidth.out_trafficobject
bandwidth.out_traffic.max_bits_per_secondnumber
bandwidth.out_traffic.transfer_bytesnumber
bandwidth.out_traffic.transfer_bits_per_secondnumber
bandwidth.out_traffic.current_bits_per_secondnumber
bandwidth.out_traffic.pointsarray

device not found

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

List all IPs of a server

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/devices/id/ips
curl --request GET \
  --url https://api.maxihost.com/devices/id/ips
var request = require("request");

var options = { method: 'GET',
  url:
   'https://api.maxihost.com/devices/id/ips' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/id/ips")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/devices/id/ips");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/id/ips"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "ips": [
    {
      "id": 6098,
      "ip_address": "10.54.158.95",
      "ip_description": "Private IPMI",
      "device_id": 613,
      "device_description": "BRC55378N7",
      "device_label": "BRC55378N7",
      "service_id": 0,
      "created_at": 1526918369,
      "updated_at": 1537818767
    },
    {
      "id": 6102,
      "ip_address": "177.54.158.95",
      "ip_description": "Public IPv4",
      "device_id": 613,
      "device_description": "BRC55378N7",
      "device_label": "BRC55378N7",
      "service_id": 0,
      "created_at": 1526928304,
      "updated_at": 1537818788
    }
  ],
  "links": {
    "self": "https://api.maxihost.com/devices/613/ips?limit=2&page=1",
    "next": "https://api.maxihost.com/devices/613/ips?limit=2&page=2",
    "last": "https://api.maxihost.com/devices/613/ips?limit=2&page=5"
  },
  "meta": {
    "pages": {
      "count": 2,
      "total": 5
    }
  }
}

Path Params

id
string
required

Query Params

page
string

The page number.

limit
string

The page size.

Response

Device found

ipsarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

Server Actions

 
Suggest Edits

Manage power of a server

 

Header Auth

 Authentication is required for this endpoint.
puthttps://api.maxihost.com/devices/id/actions
curl --request PUT \
  --url https://api.maxihost.com/devices/id/actions
var request = require("request");

var options = { method: 'PUT',
  url:
   'https://api.maxihost.com/devices/id/actions' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/id/actions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("PUT", "https://api.maxihost.com/devices/id/actions");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/id/actions"

response = requests.request("PUT", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "status": false,
  "code": "UNPROCESSABLE_ENTITY",
  "error_messages": {
    "base": [
      "Type must be one of: power_on, power_off, power_cycle"
    ]
  }
}

Path Params

id
string
required

Body Params

type
string
required

The action you want to take. Must be one of power_on, power_off, power_cycle.

Response

Device Status Updated

Unprocessable Entity

Internal Server Error

Suggest Edits

Retrieve reinstall eligibility

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/devices/id/reinstall
curl --request GET \
  --url https://api.maxihost.com/devices/id/reinstall
var request = require("request");

var options = { method: 'GET',
  url:
   'https://api.maxihost.com/devices/id/reinstall' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/id/reinstall")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/devices/id/reinstall");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/id/reinstall"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "device_id": 1,
  "last_status": null,
  "enqueued": true,
  "ready_to_deploy": true
}

Path Params

id
string
required

Response

Record found

device_idstring
last_statusstring
enqueuedboolean
ready_to_deployboolean
Suggest Edits

Reinstall a server

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.maxihost.com/devices/id/reinstall
curl --request POST \
  --url https://api.maxihost.com/devices/id/reinstall
var request = require("request");

var options = { method: 'POST',
  url:
   'https://api.maxihost.com/devices/id/reinstall' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/id/reinstall")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.maxihost.com/devices/id/reinstall");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/id/reinstall"

response = requests.request("POST", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "device_id": 1,
  "queue_id": 1
}

Path Params

id
string
required

Body Params

label
string
required

New device hostname

operating_system
string
required

Operating system slug to reinstall

ssh
array of strings

SSH names

Response

Device Added To Reinstall

device_idstring
queue_idinteger
Suggest Edits

Retrieve remote access credentials

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.maxihost.com/devices/id/remote_access
curl --request POST \
  --url https://api.maxihost.com/devices/id/remote_access
var request = require("request");

var options = { method: 'POST',
  url:
   'https://api.maxihost.com/devices/id/remote_access' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/devices/id/remote_access")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.maxihost.com/devices/id/remote_access");

xhr.send(data);
import requests

url = "https://api.maxihost.com/devices/id/remote_access"

response = requests.request("POST", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "address": "ipmi_address",
  "name": "customer",
  "password": "new_user_password"
}

Path Params

id
string
required

Response

addressstring
namestring
passwordstring
privstring
Suggest Edits

SSH Keys

 
Suggest Edits

Create an ssh key

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.maxihost.com/account/keys
curl --request POST \
  --url https://api.maxihost.com/account/keys
var request = require("request");

var options = { method: 'POST', url: 'https://api.maxihost.com/account/keys' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/account/keys")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.maxihost.com/account/keys");

xhr.send(data);
import requests

url = "https://api.maxihost.com/account/keys"

response = requests.request("POST", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 3,
  "fingerprint": "f7:4a:b7:63:b3:4d:d5:0d:50:d8:79:53:68:87:d3:c7",
  "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCgJe9hY84cYnqxBZvkNve65CPOw6l0hrV6+CmAoURHlpUYCtD4HvR67428v9iCS4kyqftJlk9f+AyG0OKexDHSHp4GiHEjEwMXqQugfbEWf0whxwCdUDd96lf1JUB0giV2+viTxhSJ0hMWX19hQs15zkSc8jZ6sV+Rs9X5awOvPs2U98eq29wlIahW6iM7dlW/UH2pbGryLOu+ESY4hrCFiPwWS1RrP+BDwipYAC1dFKG8N5b7yqQoN8OvfuvHlIGNZAkWPw5lRxUR5+YN1XSMezbcDU/Fq0vIAxxEv2RVfCrzV4FO36mC71vl+vh1jh9J8Fo4jZPf6EGM9qB1dU3d",
  "name": "My SSH key 3"
}
{
  "status": false,
  "code": "INVALID_SSH_KEY",
  "error_messages": {
    "base": [
      "public_key Invalid SSH Public Key"
    ]
  }
}

Body Params

name
string
required

A name to identify the key.

public_key
string
required

The base64 encoded sequence of the public key to be added.

Response

SSH Key created

idinteger
fingerprintstring
public_keystring
namestring

Invalid SSH Public Key

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

List all ssh keys

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/account/keys
curl --request GET \
  --url https://api.maxihost.com/account/keys
var request = require("request");

var options = { method: 'GET', url: 'https://api.maxihost.com/account/keys' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/account/keys")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/account/keys");

xhr.send(data);
import requests

url = "https://api.maxihost.com/account/keys"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "ssh_keys": [
    {
      "id": 1,
      "fingerprint": "00:6a:e2:6a:c5:ab:c4:9c:bc:f6:63:4e:04:ea:fc:8f",
      "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDoKPBoeHGlAbAvD8AuLVoHZiyo+WbzsOmM/aFI28a7zPmBzIsuoWCd9tYGZk3IjzruqYBCfsEWHF6LcBOTAahRWwPb2PF2lcoYLN+3M69OmcIWdUpinHdqDoT8ot27JJdVGdqG80FAcr6lJRifTm4JtHDdVzM0UGWlzNmMXensajSyE4V/Eh5QIRlW6l809w25WJwtDrY7pT+9ItXB9gZAsxR4o36FDLIQVZrKPRtRFmxtiAOIQBWGza4i+UqIW7ljoYMkfDEq0jTBhmJxN7cuZ9riHZtvPibLR8QViYVkTLMsrth78SNePeNkPnWW3Yl+0KSQD1M2wtCnvWJ7+6TH",
      "name": "My SSH key 1"
    }
  ],
  "links": {
    "self": "https://api.maxihost.com/account/keys?limit=1&page=1"
  },
  "meta": {
    "pages": {
      "total": 1,
      "count": 1
    }
  }
}

Query Params

page
string

The page number.

limit
string

The page size.

Response

List SSH Keys

ssh_keysarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

Retrieve an ssh key

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/account/keys/id
curl --request GET \
  --url https://api.maxihost.com/account/keys/id
var request = require("request");

var options = { method: 'GET',
  url:
   'https://api.maxihost.com/account/keys/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/account/keys/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/account/keys/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/account/keys/id"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 1,
  "fingerprint": "00:6a:e2:6a:c5:ab:c4:9c:bc:f6:63:4e:04:ea:fc:8f",
  "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDoKPBoeHGlAbAvD8AuLVoHZiyo+WbzsOmM/aFI28a7zPmBzIsuoWCd9tYGZk3IjzruqYBCfsEWHF6LcBOTAahRWwPb2PF2lcoYLN+3M69OmcIWdUpinHdqDoT8ot27JJdVGdqG80FAcr6lJRifTm4JtHDdVzM0UGWlzNmMXensajSyE4V/Eh5QIRlW6l809w25WJwtDrY7pT+9ItXB9gZAsxR4o36FDLIQVZrKPRtRFmxtiAOIQBWGza4i+UqIW7ljoYMkfDEq0jTBhmJxN7cuZ9riHZtvPibLR8QViYVkTLMsrth78SNePeNkPnWW3Yl+0KSQD1M2wtCnvWJ7+6TH",
  "name": "My SSH key 1"
}
{
  "status": false,
  "code": "SSH_KEY_NOT_FOUND",
  "error_messages": {
    "base": [
      "The provided id or fingerprint were not found."
    ]
  }
}

Path Params

id
string
required

SSH Key ID or fingerprint

Response

SSH Key retrieved

idinteger
fingerprintstring
public_keystring
namestring

Invalid id or fingerprint

statusboolean
codestring
error_messagesobject
error_messages.idarray
Suggest Edits

Update an ssh key

 

Header Auth

 Authentication is required for this endpoint.
puthttps://api.maxihost.com/account/keys/id
curl --request PUT \
  --url https://api.maxihost.com/account/keys/id
var request = require("request");

var options = { method: 'PUT',
  url:
   'https://api.maxihost.com/account/keys/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/account/keys/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("PUT", "https://api.maxihost.com/account/keys/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/account/keys/id"

response = requests.request("PUT", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 1,
  "fingerprint": "00:6a:e2:6a:c5:ab:c4:9c:bc:f6:63:4e:04:ea:fc:8f",
  "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDoKPBoeHGlAbAvD8AuLVoHZiyo+WbzsOmM/aFI28a7zPmBzIsuoWCd9tYGZk3IjzruqYBCfsEWHF6LcBOTAahRWwPb2PF2lcoYLN+3M69OmcIWdUpinHdqDoT8ot27JJdVGdqG80FAcr6lJRifTm4JtHDdVzM0UGWlzNmMXensajSyE4V/Eh5QIRlW6l809w25WJwtDrY7pT+9ItXB9gZAsxR4o36FDLIQVZrKPRtRFmxtiAOIQBWGza4i+UqIW7ljoYMkfDEq0jTBhmJxN7cuZ9riHZtvPibLR8QViYVkTLMsrth78SNePeNkPnWW3Yl+0KSQD1M2wtCnvWJ7+6TH",
  "name": "New SSH Key"
}
{
  "status": false,
  "code": "SSH_KEY_NOT_FOUND",
  "error_messages": {
    "base": [
      "The provided id or fingerprint were not found."
    ]
  }
}
{
  "status": false,
  "code": "UNPROCESSABLE_ENTITY",
  "error_messages": {
    "base": [
      "Name can't be blank"
    ]
  }
}

Path Params

id
string
required

SSH Key ID or fingerprint

Body Params

name
string

Response

SSH Key updated

idinteger
fingerprintstring
public_keystring
namestring

Invalid id or fingerprint

statusboolean
codestring
error_messagesobject
error_messages.idarray

Invalid name

statusboolean
error_messagesobject
error_messages.namearray
Suggest Edits

Delete an ssh key

 

Header Auth

 Authentication is required for this endpoint.
deletehttps://api.maxihost.com/account/keys/id
curl --request DELETE \
  --url https://api.maxihost.com/account/keys/id
var request = require("request");

var options = { method: 'DELETE',
  url:
   'https://api.maxihost.com/account/keys/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/account/keys/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("DELETE", "https://api.maxihost.com/account/keys/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/account/keys/id"

response = requests.request("DELETE", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{}
{
  "status": false,
  "code": "SSH_KEY_NOT_FOUND",
  "error_messages": {
    "base": [
      "The provided id or fingerprint were not found."
    ]
  }
}

Path Params

id
string
required

SSH Key ID or fingerprint

Response

SSH Key deleted

SSH Key not found

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

Networking

 
Suggest Edits

List all IPs

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/ips
curl --request GET \
  --url https://api.maxihost.com/ips
var request = require("request");

var options = { method: 'GET', url: 'https://api.maxihost.com/ips' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/ips")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/ips");

xhr.send(data);
import requests

url = "https://api.maxihost.com/ips"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "ips": [
    {
      "id": 6098,
      "ip_address": "177.54.158.96",
      "ip_description": "Public IPv4",
      "device_id": 613,
      "device_description": "server-hostname.com",
      "device_label": "server-hostname.com",
      "service_id": 0,
      "created_at": 1526918369,
      "updated_at": 1537818767
    },
    {
      "id": 6102,
      "ip_address": "177.54.158.95",
      "ip_description": "Public IPv4",
      "device_id": 615,
      "device_description": "server-hostname.com",
      "device_label": "server-hostname.com",
      "service_id": 0,
      "created_at": 1526928304,
      "updated_at": 1537818788
    }
  ],
  "links": {
    "self": "https://api.maxihost.com/ips?limit=2&page=1",
    "next": "https://api.maxihost.com/ips?limit=2&page=2",
    "last": "https://api.maxihost.com/ips?limit=2&page=5"
  },
  "meta": {
    "pages": {
      "count": 2,
      "total": 5
    }
  }
}

Query Params

page
string

The page number.

limit
string

The page size.

Response

IPs found

ipsarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

Plans

 
Suggest Edits

List available servers

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/plans
curl --request GET \
  --url https://api.maxihost.com/plans
var request = require("request");

var options = { method: 'GET', url: 'https://api.maxihost.com/plans' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/plans")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/plans");

xhr.send(data);
import requests

url = "https://api.maxihost.com/plans"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "servers": [
    {
      "id": 1,
      "slug": "spot_1",
      "name": "Spot",
      "line": "baremetal",
      "deploy_type": "automated",
      "specs": {
        "cpus": {
          "count": 2,
          "type": "Xeon Silver 4116",
          "cores": "24",
          "clock": "2.10"
        },
        "memory": {
          "total": "256GB"
        },
        "drives": [
          {
            "count": 2,
            "size": "500GB",
            "type": "SSD,"
          },
          {
            "count": 1,
            "size": "1TB",
            "type": "NVMe"
          }
        ]
      },
      "regions": [
        {
          "name": "Maxihost SP1",
          "code": "MH1",
          "city": "SC#o Paulo",
          "country": "Brazil",
          "in_stock": true,
          "pricing": {
            "brl_month": 689,
            "usd_month": 219,
            "brl_hour": 1.044,
            "usd_hour": 0.332
          }
        }
      ]
    }
  ],
  "links": {
    "self": "https://api.maxihost.com/plans?limit=1&page=1"
  },
  "meta": {
    "pages": {
      "count": 1,
      "total": 1
    }
  }
}

Query Params

page
string

The page number.

limit
string

The page size.

Response

Available Plans

serversarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

List available addons

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/plans/addons
curl --request GET \
  --url https://api.maxihost.com/plans/addons
var request = require("request");

var options = { method: 'GET', url: 'https://api.maxihost.com/plans/addons' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/plans/addons")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/plans/addons");

xhr.send(data);
import requests

url = "https://api.maxihost.com/plans/addons"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "additional_bandwidth": [
    {
      "id": 219,
      "name": "10 TB / 1 Gbps",
      "slug": "10_tb_1gbps",
      "description": "",
      "pricing": {
        "brl_month": 0,
        "usd_month": 0
      }
    }
  ],
  "additional_ip": [
    {
      "id": 262,
      "name": "Additional IP",
      "slug": "additional_ip",
      "description": "",
      "pricing": {
        "brl_month": 20,
        "usd_month": 6
      }
    }
  ],
  "ddos_protection": [
    {
      "id": 254,
      "name": "Standard (Up to 10 Gbps and 8Mpps)",
      "slug": "standard_(upto10gbpsand8mpps)",
      "description": "",
      "pricing": {
        "brl_month": 500,
        "usd_month": 169
      }
    }
  ],
  "hardware_firewall": [
    {
      "id": 271,
      "name": "Standard",
      "slug": "standard",
      "description": "",
      "pricing": {
        "brl_month": 99,
        "usd_month": 29
      }
    }
  ],
  "links": {
    "last": "https://api.maxihost.com/plans/addons?limit=1&page=7",
    "next": "https://api.maxihost.com/plans/addons?limit=1&page=2",
    "self": "https://api.maxihost.com/plans/addons?limit=1&page=1"
  },
  "meta": {
    "pages": {
      "count": 4,
      "total": 7
    }
  }
}

Query Params

page
string

The page number.

limit
string

The page size.

Response

Success

additional_bandwidtharray
additional_iparray
hardware_firewallarray
ddos_protectionarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

List operating systems

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/plans/operating-systems
curl --request GET \
  --url https://api.maxihost.com/plans/operating-systems
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.maxihost.com/plans/operating-systems' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/plans/operating-systems")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/plans/operating-systems");

xhr.send(data);
import requests

url = "https://api.maxihost.com/plans/operating-systems"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "operating-systems": [
    {
      "id": 32,
      "slug": "centos_6_x",
      "operating_system": "Linux",
      "distro": "CentOS",
      "name": "CentOS (6.x)",
      "version": "6.x",
      "pricing": {
        "brl_month": 0,
        "usd_month": 0
      }
    },
    {
      "id": 266,
      "slug": "windows_server_2016_r2__datacenter",
      "operating_system": "Windows",
      "distro": "Windows",
      "name": "Windows Server (2016 R2 - Datacenter)",
      "version": "2016 R2 - Datacenter",
      "pricing": {
        "brl_month": 50,
        "usd_month": 19
      }
    }
  ],
  "links": {
    "last": "https://api.maxihost.com/devices/operating-systems?limit=10&page=2",
    "next": "https://api.maxihost.com/devices/operating-systems?limit=10&page=2",
    "self": "https://api.maxihost.com/devices/operating-systems?limit=10&page=1"
  },
  "meta": {
    "pages": {
      "count": 2,
      "total": 2
    }
  }
}

Query Params

page
string

The page number.

limit
string

The page size.

Response

Operating Systems found

operating-systemsarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

Account

 
Suggest Edits

List all regions

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/regions
curl --request GET \
  --url https://api.maxihost.com/regions
var request = require("request");

var options = { method: 'GET', url: 'https://api.maxihost.com/regions' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/regions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/regions");

xhr.send(data);
import requests

url = "https://api.maxihost.com/regions"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "regions": [
    {
      "slug": "MH1",
      "name": "Maxihost SP1",
      "location": {
        "city": "SC#o Paulo",
        "country": "BR"
      },
      "available": 1,
      "features": [
        "bare_metal",
        "firewall",
        "backup"
      ]
    }
  ],
  "links": {
    "self": "https://api.maxihost.com/regions?limit=1&page=1"
  },
  "meta": {
    "pages": {
      "count": 1,
      "total": 1
    }
  }
}

Query Params

page
string

The page number.

limit
string

The page size.

Response

Available Regions

regionsarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

List all roles

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/roles
curl --request GET \
  --url https://api.maxihost.com/roles
var request = require("request");

var options = { method: 'GET', url: 'https://api.maxihost.com/roles' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/roles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/roles");

xhr.send(data);
import requests

url = "https://api.maxihost.com/roles"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "roles": [
    {
      "id": 1,
      "name": "Full Permission"
    },
    {
      "id": 2,
      "name": "Collaborator"
    },
    {
      "id": 3,
      "name": "Billing"
    }
  ]
}

Response

Roles found

rolesarray
Suggest Edits

Retrieve a role

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/roles/id
curl --request GET \
  --url https://api.maxihost.com/roles/id
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.maxihost.com/roles/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/roles/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/roles/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/roles/id"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 1,
  "name": "Full Permission",
  "acls": {
    "type": "object",
    "properties": {
      "client.portal": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.client_profile": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.profile": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.billing_info": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.change_password": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.manage_contacts": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.manage_contact_facilities": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.billing_services": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.invoices": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.service": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.credits": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.quotes": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.billing_email": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.reports": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.event_log": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.mail_log": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.ledger_log": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.domain_management": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.list_domains": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.lookup_domain": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.support": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.tickets": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.all_tickets": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.search_ticket": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.device_manager": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.devices": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.racks": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.cages": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.facilities": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.ip_addresses": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.dns_zone": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.dns_record": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      }
    }
  }
}
{
  "id": 1,
  "name": "Full Permission",
  "acls": {
    "type": "object",
    "properties": {
      "client.portal": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.client_profile": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.profile": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.billing_info": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.change_password": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.manage_contacts": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.manage_contact_facilities": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.billing_services": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.invoices": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.service": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.credits": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.quotes": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.billing_email": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.reports": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.event_log": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.mail_log": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.ledger_log": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.domain_management": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.list_domains": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.lookup_domain": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.support": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.tickets": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.all_tickets": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.search_ticket": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.device_manager": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.devices": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.racks": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.cages": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.facilities": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.ip_addresses": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.dns_zone": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      },
      "client.dns_record": {
        "type": "object",
        "properties": {
          "create": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "read": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "update": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          },
          "delete": {
            "type": "string",
            "enum": [
              "-1",
              "0",
              "1"
            ]
          }
        }
      }
    }
  }
}

Path Params

id
string
required

Response

Role found

idinteger
namestring
aclsobject
acls.client.portalobject
acls.client.portal.createstring
acls.client.portal.readstring
acls.client.portal.updatestring
acls.client.portal.deletestring
acls.client.client_profileobject
acls.client.client_profile.createstring
acls.client.client_profile.readstring
acls.client.client_profile.updatestring
acls.client.client_profile.deletestring
acls.client.profileobject
acls.client.profile.createstring
acls.client.profile.readstring
acls.client.profile.updatestring
acls.client.profile.deletestring
acls.client.billing_infoobject
acls.client.billing_info.createstring
acls.client.billing_info.readstring
acls.client.billing_info.updatestring
acls.client.billing_info.deletestring
acls.client.change_passwordobject
acls.client.change_password.createstring
acls.client.change_password.readstring
acls.client.change_password.updatestring
acls.client.change_password.deletestring
acls.client.manage_contactsobject
acls.client.manage_contacts.createstring
acls.client.manage_contacts.readstring
acls.client.manage_contacts.updatestring
acls.client.manage_contacts.deletestring
acls.client.manage_contact_facilitiesobject
acls.client.manage_contact_facilities.createstring
acls.client.manage_contact_facilities.readstring
acls.client.manage_contact_facilities.updatestring
acls.client.manage_contact_facilities.deletestring
acls.client.billing_servicesobject
acls.client.billing_services.createstring
acls.client.billing_services.readstring
acls.client.billing_services.updatestring
acls.client.billing_services.deletestring
acls.client.invoicesobject
acls.client.invoices.createstring
acls.client.invoices.readstring
acls.client.invoices.updatestring
acls.client.invoices.deletestring
acls.client.serviceobject
acls.client.service.createstring
acls.client.service.readstring
acls.client.service.updatestring
acls.client.service.deletestring
acls.client.creditsobject
acls.client.credits.createstring
acls.client.credits.readstring
acls.client.credits.updatestring
acls.client.credits.deletestring
acls.client.quotesobject
acls.client.quotes.createstring
acls.client.quotes.readstring
acls.client.quotes.updatestring
acls.client.quotes.deletestring
acls.client.billing_emailobject
acls.client.billing_email.createstring
acls.client.billing_email.readstring
acls.client.billing_email.updatestring
acls.client.billing_email.deletestring
acls.client.reportsobject
acls.client.reports.createstring
acls.client.reports.readstring
acls.client.reports.updatestring
acls.client.reports.deletestring
acls.client.event_logobject
acls.client.event_log.createstring
acls.client.event_log.readstring
acls.client.event_log.updatestring
acls.client.event_log.deletestring
acls.client.mail_logobject
acls.client.mail_log.createstring
acls.client.mail_log.readstring
acls.client.mail_log.updatestring
acls.client.mail_log.deletestring
acls.client.ledger_logobject
acls.client.ledger_log.createstring
acls.client.ledger_log.readstring
acls.client.ledger_log.updatestring
acls.client.ledger_log.deletestring
acls.client.domain_managementobject
acls.client.domain_management.createstring
acls.client.domain_management.readstring
acls.client.domain_management.updatestring
acls.client.domain_management.deletestring
acls.client.list_domainsobject
acls.client.list_domains.createstring
acls.client.list_domains.readstring
acls.client.list_domains.updatestring
acls.client.list_domains.deletestring
acls.client.lookup_domainobject
acls.client.lookup_domain.createstring
acls.client.lookup_domain.readstring
acls.client.lookup_domain.updatestring
acls.client.lookup_domain.deletestring
acls.client.supportobject
acls.client.support.createstring
acls.client.support.readstring
acls.client.support.updatestring
acls.client.support.deletestring
acls.client.ticketsobject
acls.client.tickets.createstring
acls.client.tickets.readstring
acls.client.tickets.updatestring
acls.client.tickets.deletestring
acls.client.all_ticketsobject
acls.client.all_tickets.createstring
acls.client.all_tickets.readstring
acls.client.all_tickets.updatestring
acls.client.all_tickets.deletestring
acls.client.search_ticketobject
acls.client.search_ticket.createstring
acls.client.search_ticket.readstring
acls.client.search_ticket.updatestring
acls.client.search_ticket.deletestring
acls.client.device_managerobject
acls.client.device_manager.createstring
acls.client.device_manager.readstring
acls.client.device_manager.updatestring
acls.client.device_manager.deletestring
acls.client.devicesobject
acls.client.devices.createstring
acls.client.devices.readstring
acls.client.devices.updatestring
acls.client.devices.deletestring
acls.client.racksobject
acls.client.racks.createstring
acls.client.racks.readstring
acls.client.racks.updatestring
acls.client.racks.deletestring
acls.client.cagesobject
acls.client.cages.createstring
acls.client.cages.readstring
acls.client.cages.updatestring
acls.client.cages.deletestring
acls.client.facilitiesobject
acls.client.facilities.createstring
acls.client.facilities.readstring
acls.client.facilities.updatestring
acls.client.facilities.deletestring
acls.client.ip_addressesobject
acls.client.ip_addresses.createstring
acls.client.ip_addresses.readstring
acls.client.ip_addresses.updatestring
acls.client.ip_addresses.deletestring
acls.client.dns_zoneobject
acls.client.dns_zone.createstring
acls.client.dns_zone.readstring
acls.client.dns_zone.updatestring
acls.client.dns_zone.deletestring
acls.client.dns_recordobject
acls.client.dns_record.createstring
acls.client.dns_record.readstring
acls.client.dns_record.updatestring
acls.client.dns_record.deletestring

Role not found

idinteger
namestring
aclsobject
acls.client.portalobject
acls.client.portal.createstring
acls.client.portal.readstring
acls.client.portal.updatestring
acls.client.portal.deletestring
acls.client.client_profileobject
acls.client.client_profile.createstring
acls.client.client_profile.readstring
acls.client.client_profile.updatestring
acls.client.client_profile.deletestring
acls.client.profileobject
acls.client.profile.createstring
acls.client.profile.readstring
acls.client.profile.updatestring
acls.client.profile.deletestring
acls.client.billing_infoobject
acls.client.billing_info.createstring
acls.client.billing_info.readstring
acls.client.billing_info.updatestring
acls.client.billing_info.deletestring
acls.client.change_passwordobject
acls.client.change_password.createstring
acls.client.change_password.readstring
acls.client.change_password.updatestring
acls.client.change_password.deletestring
acls.client.manage_contactsobject
acls.client.manage_contacts.createstring
acls.client.manage_contacts.readstring
acls.client.manage_contacts.updatestring
acls.client.manage_contacts.deletestring
acls.client.manage_contact_facilitiesobject
acls.client.manage_contact_facilities.createstring
acls.client.manage_contact_facilities.readstring
acls.client.manage_contact_facilities.updatestring
acls.client.manage_contact_facilities.deletestring
acls.client.billing_servicesobject
acls.client.billing_services.createstring
acls.client.billing_services.readstring
acls.client.billing_services.updatestring
acls.client.billing_services.deletestring
acls.client.invoicesobject
acls.client.invoices.createstring
acls.client.invoices.readstring
acls.client.invoices.updatestring
acls.client.invoices.deletestring
acls.client.serviceobject
acls.client.service.createstring
acls.client.service.readstring
acls.client.service.updatestring
acls.client.service.deletestring
acls.client.creditsobject
acls.client.credits.createstring
acls.client.credits.readstring
acls.client.credits.updatestring
acls.client.credits.deletestring
acls.client.quotesobject
acls.client.quotes.createstring
acls.client.quotes.readstring
acls.client.quotes.updatestring
acls.client.quotes.deletestring
acls.client.billing_emailobject
acls.client.billing_email.createstring
acls.client.billing_email.readstring
acls.client.billing_email.updatestring
acls.client.billing_email.deletestring
acls.client.reportsobject
acls.client.reports.createstring
acls.client.reports.readstring
acls.client.reports.updatestring
acls.client.reports.deletestring
acls.client.event_logobject
acls.client.event_log.createstring
acls.client.event_log.readstring
acls.client.event_log.updatestring
acls.client.event_log.deletestring
acls.client.mail_logobject
acls.client.mail_log.createstring
acls.client.mail_log.readstring
acls.client.mail_log.updatestring
acls.client.mail_log.deletestring
acls.client.ledger_logobject
acls.client.ledger_log.createstring
acls.client.ledger_log.readstring
acls.client.ledger_log.updatestring
acls.client.ledger_log.deletestring
acls.client.domain_managementobject
acls.client.domain_management.createstring
acls.client.domain_management.readstring
acls.client.domain_management.updatestring
acls.client.domain_management.deletestring
acls.client.list_domainsobject
acls.client.list_domains.createstring
acls.client.list_domains.readstring
acls.client.list_domains.updatestring
acls.client.list_domains.deletestring
acls.client.lookup_domainobject
acls.client.lookup_domain.createstring
acls.client.lookup_domain.readstring
acls.client.lookup_domain.updatestring
acls.client.lookup_domain.deletestring
acls.client.supportobject
acls.client.support.createstring
acls.client.support.readstring
acls.client.support.updatestring
acls.client.support.deletestring
acls.client.ticketsobject
acls.client.tickets.createstring
acls.client.tickets.readstring
acls.client.tickets.updatestring
acls.client.tickets.deletestring
acls.client.all_ticketsobject
acls.client.all_tickets.createstring
acls.client.all_tickets.readstring
acls.client.all_tickets.updatestring
acls.client.all_tickets.deletestring
acls.client.search_ticketobject
acls.client.search_ticket.createstring
acls.client.search_ticket.readstring
acls.client.search_ticket.updatestring
acls.client.search_ticket.deletestring
acls.client.device_managerobject
acls.client.device_manager.createstring
acls.client.device_manager.readstring
acls.client.device_manager.updatestring
acls.client.device_manager.deletestring
acls.client.devicesobject
acls.client.devices.createstring
acls.client.devices.readstring
acls.client.devices.updatestring
acls.client.devices.deletestring
acls.client.racksobject
acls.client.racks.createstring
acls.client.racks.readstring
acls.client.racks.updatestring
acls.client.racks.deletestring
acls.client.cagesobject
acls.client.cages.createstring
acls.client.cages.readstring
acls.client.cages.updatestring
acls.client.cages.deletestring
acls.client.facilitiesobject
acls.client.facilities.createstring
acls.client.facilities.readstring
acls.client.facilities.updatestring
acls.client.facilities.deletestring
acls.client.ip_addressesobject
acls.client.ip_addresses.createstring
acls.client.ip_addresses.readstring
acls.client.ip_addresses.updatestring
acls.client.ip_addresses.deletestring
acls.client.dns_zoneobject
acls.client.dns_zone.createstring
acls.client.dns_zone.readstring
acls.client.dns_zone.updatestring
acls.client.dns_zone.deletestring
acls.client.dns_recordobject
acls.client.dns_record.createstring
acls.client.dns_record.readstring
acls.client.dns_record.updatestring
acls.client.dns_record.deletestring
Suggest Edits

List all users

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/users
curl --request GET \
  --url https://api.maxihost.com/users
var request = require("request");

var options = { method: 'GET', url: 'https://api.maxihost.com/users' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/users")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/users");

xhr.send(data);
import requests

url = "https://api.maxihost.com/users"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "users": [
    {
      "id": 237,
      "description": "Primary Contact",
      "email": "[email protected]",
      "name": "MaxiHost LTDA",
      "roles": [
        {
          "id": 1,
          "name": "Full Permissions"
        },
        {
          "id": 4,
          "name": "API"
        }
      ]
    }
  ],
  "links": {
    "first": "https://api.maxihost.com/users?limit=1&page=1",
    "last": "https://api.maxihost.com/users?limit=1&page=19",
    "next": "https://api.maxihost.com/users?limit=1&page=4",
    "prev": "https://api.maxihost.com/users?limit=1&page=2",
    "self": "https://api.maxihost.com/users?limit=1&page=3"
  },
  "meta": {
    "pages": {
      "count": 1,
      "total": 19
    }
  }
}

Query Params

status
integer

An integer value to show user current status

page
string

The page number.

limit
string

The page size.

Response

Users found

usersarray
linksobject
links.firststring
links.laststring
links.nextstring
links.prevstring
links.selfstring
metaobject
meta.pagesobject
meta.pages.totalinteger
meta.pages.countinteger
Suggest Edits

Create a user

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.maxihost.com/users
curl --request POST \
  --url https://api.maxihost.com/users
var request = require("request");

var options = { method: 'POST', url: 'https://api.maxihost.com/users' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/users")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.maxihost.com/users");

xhr.send(data);
import requests

url = "https://api.maxihost.com/users"

response = requests.request("POST", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
Try the API to see results

Body Params

email
string
required

User email address

name
string
required

User name

role_ids
array of strings

Response

User created

Unprocessable

Suggest Edits

Retrieve an user

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.maxihost.com/users/id
curl --request GET \
  --url https://api.maxihost.com/users/id
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.maxihost.com/users/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/users/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.maxihost.com/users/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/users/id"

response = requests.request("GET", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "id": 237,
  "description": "Primary Contact",
  "email": "[email protected]",
  "name": "MaxiHost LTDA",
  "roles": [
    {
      "id": 1,
      "name": "Full Permissions"
    },
    {
      "id": 4,
      "name": "API"
    }
  ]
}
{
  "status": false,
  "code": "USER_NOT_FOUND",
  "error_messages": {
    "base": [
      "User not found."
    ]
  }
}

Path Params

id
string
required

Response

User found

idinteger
is_ownerboolean
emailstring
namestring
rolesarray

User not found

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

Update a user

 

Header Auth

 Authentication is required for this endpoint.
puthttps://api.maxihost.com/users/id
curl --request PUT \
  --url https://api.maxihost.com/users/id
var request = require("request");

var options = { method: 'PUT',
  url: 'https://api.maxihost.com/users/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/users/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("PUT", "https://api.maxihost.com/users/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/users/id"

response = requests.request("PUT", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "status": false,
  "code": "USER_UPDATE_FAILURE",
  "error_messages": {
    "base": [
      "Sorry, user with property [email protected] already exists."
    ]
  }
}

Path Params

id
string
required

Body Params

email
string
required

User email address

name
string
required

User name

role_ids
array of strings

Response

User updated

Unprocessable

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

Delete a user

 

Header Auth

 Authentication is required for this endpoint.
deletehttps://api.maxihost.com/users/id
curl --request DELETE \
  --url https://api.maxihost.com/users/id
var request = require("request");

var options = { method: 'DELETE',
  url: 'https://api.maxihost.com/users/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.maxihost.com/users/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("DELETE", "https://api.maxihost.com/users/id");

xhr.send(data);
import requests

url = "https://api.maxihost.com/users/id"

response = requests.request("DELETE", url)

print(response.text)
A binary file was returned

You couldn't be authenticated

{{ results.method }}
{{ results.url }}
{{ results.requestHeaders }}
{{ results.data }}
{{ results.responseHeaders }}
{
  "status": false,
  "code": "USER_DELETE_FAILURE",
  "error_messages": {
    "base": [
      "Smith::Errors::Unprocessable"
    ]
  }
}

Path Params

id
string
required

Response

User deleted

Unprocessable

statusboolean
codestring
error_messagesobject
error_messages.basearray
Suggest Edits

Error Objects

 

The API will return an Error List for a failed request, which will contain one or more Error objects.

Error List Attributes

Each error has the following attributes

Field
Description

status

The status is false

code

General context about the error. See Error Codes.

error_messages

An array of one or more error objects.

Error Object Attributes

Each Error Object has the following attributes

Field
Description

base

Human readable description of the error

Error List Object

{
  "status": "error.list",
  "errors": [
    {
      "code": "not_found",
      "message": "No such user_id[494817923]",
      "field": "user_id"
    },
    {
      "code": "not_found",
      "message": "No such email[[email protected]]",
      "field": "email"
    }
  ]
}
Suggest Edits

Error Codes

 

The API may send the following error codes. Other codes may be added in the future.

Field
Description

CLIENT_ERROR

Generic server error

TIMEOUT

Timeout error

UNAUTHORIZED_REQUEST

The request was not authorized. Check your token.

FORBIDDEN_REQUEST

The request was forbidden. Check your token.

INVALID_CREDENTIALS

The credentials are invalid. Check your data.

UNPROCESSABLE_ENTITY

Cannot process the request. Check your data.

INVALID_TOKEN

The token is invalid. Request a new token.

REVOKED_TOKEN

The token is revoked. Request a new token.

MISSING_TOKEN

The token is missing. Check your token.

EXPIRED_TOKEN

The token is expired. Request a new token.

ACCOUNT_LOGIN_FAILURE

Failure to log in. Check your credentials.

MALFORMED_PAYLOAD

Your payload is wrong. Check your data.

PRIMARY_USER_EDIT

Cannot update the primary user. Select another user to update.

<ITEM>_NOT_FOUND

<ITEM> not found. Check your data.

UPDATE_CONTACT

Failure updating a contact. Check your data.

NOT_FOUND

Generic error when the subject is not found

INVALID_UPDATE

Failure updating the subject. Check your data.

<ITEM>_LIST_FAILURE

Failure listing available <ITEM>. Try again later.

<ITEM>_UPDATE_FAILURE

Failure updating <ITEM>. Try again later.

<ITEM>_CREATE_FAILURE

Failure creating <ITEM>. Try again later.

Suggest Edits

HTTP Responses

 

The API returns HTTP responses on each request to indicate the success or otherwise of API requests. The codes listed below are often used, and the API may use others. Note that 4xx and 5xx responses may be returned for any request and clients should cater for them.

Response Code
Description

200

Ok -- The request was successful.

201

Created -- The request was successful.

400

Bad Request -- General client error, possibly malformed data.

401

Unauthorized -- The API Key was not authorised (or no API Key was found).

403

Forbidden -- The request is not allowed.

404

Not Found -- The resource was not found.

422

Unprocessable Entity -- The data was well-formed but invalid.

429

Too Many Requests -- The client has reached or exceeded a rate limit, or the server is overloaded.

500

Server errors - something went wrong with Maxihost's servers.

This response is most likely a momentary operational error (e.g. temporary unavailability), and, as a result, requests should be retried once.

Suggest Edits

Object Model

 

Commond Fields

API objects have a type field indicating their object type. Each object in the API may be given an identifier, indicated via its id field, and will typically be addressable via a URI. Many objects will also have a created field indicating the object's creation date as a UTC Unix timestamp.

Dates and Timestamps

All temporal fields in the API are encoded as Unix timestamps and are by definition always treated as UTC. The most common time fields in the API are created and updated.

Paramater
Description

created_at

The time the object was created. In most, but not all cases, this is the time the object was created according to the API server.

updated_at

The time the object was last updated according to the API server.

Optional Fields

Unpopulated optional data is returned as follows

  • Number, String, and Boolean types may be returned as having null values.
  • Arrays and Objects may be returned as empty ([] {})

In general clients should be able to handle null and empty fields.

Metadata and Custom Attributes

Some object types, such as Devices, have a metadata field that allows clients to set custom-defined data about an object.

Suggest Edits

Encoding

 

Data is encoded as defined by JSON in RFC4627. The default encoding for APIs is UTF-8. Certain characters, such as Emoji may be handled as surrogate unicode pairs (see section '2.5. Strings' of RFC4627).

Some query parameters may need to be url encoded when sending - for example, the email parameter value used to query users should be encoded.

HTML Encoding

It should be noted that the following identifiers are encoded to protect from potential cross-site scripting attacks: 'name', 'user_id', 'company_id' and 'email'. As a result you may see these identifiers in their encoded format when you retrieve them via the API.
Note that the characters we encode are double quote, single quote, ampersand, less than and greater than symbols i.e " ' & < >

Let's say you have a company name like "BL&T's". 
Then when you retrieve it from the API it will look like this:
"BL&amp;T&#39;s"
Suggest Edits

Identifiers and URLs

 

All objects in the API have an id field indicating their logical identifier. Some objects may optionally also have a self field that indicates a URL or canonical address for the object.

Parameter
Description

id

A string that identifies the object within the API. The id field will not be larger than 128 characters (in SQL it corresponds to a varchar(128)).

self

A URL that addresses the object within the API. The self field will not be larger than 255 characters (in SQL it corresponds to a varchar(255)).

These fields must always be treated as opaque strings - no guarantees are made about the internal structure of the id or self fields for an object.

The id field is always defined by the API server and is guaranteed to be unique relative to the type field - this means no two user objects will have the same id field, but a user and a company may have the same value for their id fields.

Suggest Edits

Pagination

 

List resources in the API are paginated by default to allow clients to traverse data over multiple requests. In most cases we're geared towards a default pagination limit of 10 resources per page which can be overridden via ?limit=<number>&page=<page number> query parameters. Pagination can also be toggled off via ?limit=0 query string

List resources in the API are paginated by default to allow clients to traverse data over multiple requests. In most cases we're geared towards a default pagination limit of 10 resources per page which can be overridden via ?limit=<number>&page=<page number> query parameters.

The Maxihost API provides a Link header according to RFC5988 that can be used to retrieve the next page.

Here's an example response header from requesting the third page of servers:
Link: <https://api.maxihost.com/devices?page=3>; rel="next"

If the Link header is blank, that's the last page. The Maxihost API also provides the following pagination totals

Header
Description

X-Total-Count

Total number of resources you're fetching

X-Total-Pages

The total number of pages

The API also provides links and meta/pages nodes that provide additional pagination data. Here's an example from requesting ?page=2 of devices

"links": {
        "first": "https://api.maxihost.com/devices?limit=2&page=1",
        "last": "https://api.maxihost.com/devices?limit=2&page=10",
        "next": "https://api.maxihost.com/devices?limit=2&page=3",
        "prev": "https://api.maxihost.com/devices?limit=2&page=1",
        "self": "https://api.maxihost.com/devices?limit=2&page=2"
    },
    "meta": {
        "pages": {
            "count": 2,
            "total": 10
        }
    }
name
description

first

The first page. Included when the current page is greater than 1

last

The last page

next

The next page. Included when there's a next page

prev

The previous page. Included when there's a previous page

self

The current page

meta/pages/count

The total number of resources

meta/pages/total

The total number of pages

Suggest Edits

Use of HTTP

 

Request methods are used in accordance with HTTP

  • GET is used to access resources and perform queries. The API does not allow modifications (creates, updates, deletes) to occur via GET.
  • POST is used to create or update resources. The preferred model for creation is to post JSON to a 'collections' resource - for example the collections resource for users is https://api.maxihost.com/users. PATCH is not currently used by the API.
  • DELETE is used to delete resources.

Responses use standard HTTP codes. Where there are client or server errors, a list of of one or more errors in JSON format is returned in the body - see "Errors" for more details.

The API may send cache directives where suitable, notably the ETag, Last-Modified and If-Modified-Since headers.

The Accept header must be used by a client used to indicate a preferred response for GET/HEAD requests. Requests without an Accept header of application/json may be rejected with a client error of 404 or 406. The Content-Type header should be used by clients to indicate the submitted format for POST/PUT requests.

Suggest Edits

Compatibility

 

JSON objects in the API follow a must ignore processing model, where clients are expected to ignore data fields they don't understand.

For example if the client saw the JSON as shown in the example on the right ('Unknown Field')
and did not understand the such_key field, it must pretend the field wasn't there and will process the object as if it looked liked the object shown in 'Must Ignore'.

When fetching content, fields that are optional for API objects are indicated in the documentation - clients must not assume they will always be present. When submitting content, fields that are required to be sent by client are also indicated in the documentation - if these are not sent the API may reject the request.

In general the API may reject JSON where data is not valid or incomplete with a 422 Unprocessable Entity response and an error message explaining the issue.

Unknown Field

{
  "type": "user",
  "user_id" : "456456",
  "email" : "[email protected]",
  "such_key": "so_value"
}

Must Ignore Interpretation

{
  "type": "user",
  "user_id" : "456456",
  "email" : "[email protected]"
}