Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HorizonIQ Servers API

Endpoints related to Servers

HorizonIQ Servers API is one of 9 APIs that HorizonIQ publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Servers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 14 operations across 13 paths, and defines 18 schemas. It is described by OpenAPI 3.0.1, at version 2023-05-30T22:28:43Z.

Requests are made against a single base URL, https://api.compass.horizoniq.com/{basePath}.

14 operations 13 paths 18 schemas 9 GET3 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2023-05-30T22:28:43Z
Base URL
https://api.compass.horizoniq.com/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

HorizonIQ Servers API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — API token issued from the Compass portal (Profile API Tokens). Sent as Authorization: Bearer . See https://compass-horizoniq.readme.io/reference/authentication

Paths & Operations 14

Across 13 paths, the API surfaces 14 operations — 9 GET, 3 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Servers 14

Endpoints related to Servers

GET
/servers/{serverUUID}/action-items/inactive
List Inactive Server Action Items
getServersByServerUUIDActionItemsInactive 5 params → 200400404500
GET
/servers/{serverUUID}/action-items
List Server Action Items
getServersByServerUUIDActionItems 5 params → 200400404500
GET
/servers/{serverUUID}/images
List Server Reinstall Images
getServersByServerUUIDImages 7 params → 200404501
GET
/servers/{serverUUID}/install-progress
Get Server Install Progress
getServersByServerUUIDInstallProgress 2 params → 200400404500
GET
/servers/{serverUUID}/networks
Get Server Networks
getServersByServerUUIDNetworks 2 params → 200500
GET
/servers/{serverUUID}/rdns
Get Server Reverse DNS
getServersByServerUUIDRdns 7 params → 200500
GET
/servers/{serverUUID}/root-password
Get Root Password
getServersByServerUUIDRootPassword 3 params → 200500
PATCH
/servers/{serverUUID}/root-password
Update Root Password
updateServersByServerUUIDRootPassword 3 params body → 200500
GET
/servers/{serverUUID}
Get Server
getServersByServerUUID 2 params → 200404
GET
/servers
List Servers
getServers 6 params → 200
PATCH
/servers/maintenance
Server Maintenance
updateServersMaintenance 1 param body → 200207
PATCH
/servers/{serverUUID}/rdns/{rdnsRecUUID}
Update Reverse DNS Record
updateServersByServerUUIDRdnsByRdnsRecUUID 3 params body → 200400
POST
/servers/{serverUUID}/reboot
Reboot Server
createServersByServerUUIDReboot 3 params → 200400404409501
POST
/servers/{serverUUID}/reinstall
Reinstall Server
createServersByServerUUIDReinstall 3 params body → 200400404409501

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are ServerGetModel (29 properties), ActionItemsGetModel (27 properties), ServerReverseDNSGetModel (8 properties), ServerListModel (6 properties). Each schema is shown below with its type and property counts.

RootPasswordGetModel
object
1 property
ServerNetworksGetModel
object
2 properties
ServersMaintenancePatchModel
object
1 property
ErrorModel
object
1 property
ServerReverseDNSGetModel
object
8 properties
ActionItemsListModel
object
6 properties
ServerMaintenanceRespModel
object
2 properties
ServerListModel
object
6 properties
RootPasswordPatchModel
object
1 property
InstallProgressResponseModel
object
5 properties
ActionItemsGetModel
object
27 properties
ImageListModel
object
6 properties
ServerMaintenanceObjectModel
object
2 properties
ReinstallModel
object
3 properties
ServerGetModel
object
29 properties
ReinstallPostModel
object
6 properties 2 required
ServerRdnsFqdnPatchModel
object
1 property
SuccessModel
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

horizoniq-servers-api-openapi.yml Raw ↑

Other APIs HorizonIQ publishes across the network.

HorizonIQ Action Items API
HorizonIQ Billing API
HorizonIQ Devices API
HorizonIQ Images API
HorizonIQ Managed Firewalls API
HorizonIQ SSL Certificates API
HorizonIQ Support API
HorizonIQ User Accounts API