{ "opencollection": "1.0.0", "info": { "name": "Compass Action Items Servers API", "version": "2023-05-30T22:28:43Z" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Servers", "type": "folder" }, "items": [ { "info": { "name": "List Inactive Server Action Items", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/action-items/inactive", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." }, { "name": "limit", "value": "", "type": "query", "description": "limits the number of returned systems" }, { "name": "sortby", "value": "", "type": "query", "description": "Name of key on which to sort object list." }, { "name": "offset", "value": "", "type": "query", "description": "Designates the start index of the object list." } ] }, "docs": "Retrieves a JSON object containing a list of inactive action items for a system / server." }, { "info": { "name": "List Server Action Items", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/action-items", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." }, { "name": "limit", "value": "", "type": "query", "description": "limits the number of returned systems" }, { "name": "sortby", "value": "", "type": "query", "description": "Name of key on which to sort object list." }, { "name": "offset", "value": "", "type": "query", "description": "Designates the start index of the object list." } ] }, "docs": "Retrieves a JSON object containing a list of action items for a system / server." }, { "info": { "name": "List Server Reinstall Images", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/images", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." }, { "name": "limit", "value": "", "type": "query", "description": "limits the number of returned systems" }, { "name": "offset", "value": "", "type": "query", "description": "Designates the start index of the object list." }, { "name": "direction", "value": "", "type": "query", "description": "Object list sort direction." }, { "name": "sortby", "value": "", "type": "query", "description": "Name of key on which to sort object list." }, { "name": "filter", "value": "", "type": "query", "description": "Name of filter, currently active is only filter supported." } ] }, "docs": "Retrieves a JSON object containing a list of images by serverUUID available for server reinstall." }, { "info": { "name": "Get Server Install Progress", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/install-progress", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." } ] }, "docs": "Retrieves a JSON object containing the progress of server install by UUID. This UUID can be retrieved from /servers." }, { "info": { "name": "Get Server Networks", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/networks", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." } ] }, "docs": "Retrieves a JSON object containing the server public and private networks by UUID. This UUID can be retrieved from /servers." }, { "info": { "name": "Get Server Reverse DNS", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/rdns", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." }, { "name": "limit", "value": "", "type": "query", "description": "limits the number of returned systems" }, { "name": "offset", "value": "", "type": "query", "description": "Designates the start index of the object list." }, { "name": "direction", "value": "", "type": "query", "description": "Object list sort direction." }, { "name": "sortby", "value": "", "type": "query", "description": "Name of key on which to sort object list." }, { "name": "filters", "value": "", "type": "query", "description": "Filter on object property.
**Example: ?filters[objectPropertyName]=objectPropertyValue**
\n[block:callout] { \"type\": \"info\", \"title\": \"Regular Expression Filtering.\", \"body\": \"The property value can be a valid regular expression to better define list results. The regex must contain valid delimiters such as /.\" } [/block]\n" } ] }, "docs": "Retrieves a JSON object containing the server reverse DNS configuration. This UUID can be retrieved from /servers." }, { "info": { "name": "Get Root Password", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/root-password", "headers": [ { "name": "X-Additional-Authorization", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." } ] }, "docs": "Retrieves a JSON object containing the server root passowrd by server UUID. This UUID can be retrieved from /servers." }, { "info": { "name": "Update Root Password", "type": "http" }, "http": { "method": "PATCH", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/root-password", "headers": [ { "name": "X-Additional-Authorization", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates root password in portal to the value set on the server by serverUUID. This UUID can be retrieved from /servers.

\n[block:callout] { \"type\": \"danger\", \"title\": \"Warning:\", \"body\": \"This operation does not set the actual password on the server. After changing your root password on your server, update here to keep in sync.\" } [/block]\n" }, { "info": { "name": "Get Server", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." } ] }, "docs": "Retrieves a JSON object containing a single server by serverUUID." }, { "info": { "name": "List Servers", "type": "http" }, "http": { "method": "GET", "url": "https://api.compass.horizoniq.com/{basePath}/servers", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "direction", "value": "", "type": "query", "description": "Object list sort direction." }, { "name": "limit", "value": "", "type": "query", "description": "limits the number of returned systems" }, { "name": "sortby", "value": "", "type": "query", "description": "Name of key on which to sort object list." }, { "name": "offset", "value": "", "type": "query", "description": "Designates the start index of the object list." }, { "name": "filters", "value": "", "type": "query", "description": "Filter on object property.
**Example: ?filters[objectPropertyName]=objectPropertyValue**
\n[block:callout] { \"type\": \"info\", \"title\": \"Regular Expression Filtering.\", \"body\": \"The property value can be a valid regular expression to better define list results. The regex must contain valid delimiters such as /.\" } [/block]\n" } ] }, "docs": "Retrieves a JSON object containing a list of servers currently provisioned in inventory." }, { "info": { "name": "Server Maintenance", "type": "http" }, "http": { "method": "PATCH", "url": "https://api.compass.horizoniq.com/{basePath}/servers/maintenance", "headers": [ { "name": "Authorization", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Activate / deactivate maintenance mode for one or more servers. Activating maintenance mode suppresses alerts for the server(s).

\n[block:callout] { \"type\": \"info\", \"title\": \"Information.\", \"body\": \"This operation is only for monitored servers.\" } [/block]\n" }, { "info": { "name": "Update Reverse DNS Record", "type": "http" }, "http": { "method": "PATCH", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/rdns/:rdnsRecUUID", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "rdnsRecUUID", "value": "", "type": "path", "description": "The UUID of the reverse DNS record, can be retrieved from the /servers/{serverUUID}/rdns endpoint." }, { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Apply new FQDN to reverse DNS record." }, { "info": { "name": "Reboot Server", "type": "http" }, "http": { "method": "POST", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/reboot", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "rebootType", "value": "", "type": "query", "description": "Options include soft (proper reboot) or hard (force reboot)." }, { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." } ] }, "docs": "Requests the reboot of a server by serverUUID. A simple JSON object containing success: true | false is returned." }, { "info": { "name": "Reinstall Server", "type": "http" }, "http": { "method": "POST", "url": "https://api.compass.horizoniq.com/{basePath}/servers/:serverUUID/reinstall", "headers": [ { "name": "X-Additional-Authorization", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "serverUUID", "value": "", "type": "path", "description": "The UUID of the server, can be retrieved from the **[List Servers](./get_servers)** endpoint." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Start a server re-installation" } ] } ], "bundled": true }