Examples

GET /api
200
{
  "links": {
    "base": {},
    "config_reports": {
      "List all reports": "/api/config_reports",
      "Show a report": "/api/config_reports/:id",
      "Create a report": "/api/config_reports",
      "Delete a report": "/api/config_reports/:id",
      "Show the last report for a host": "/api/hosts/:host_id/config_reports/last"
    },
    "ssh_keys": {
      "List all SSH keys for a user": "/api/users/:user_id/ssh_keys",
      "Show an SSH key from a user": "/api/users/:user_id/ssh_keys/:id",
      "Add an SSH key for a user": "/api/users/:user_id/ssh_keys",
      "Delete an SSH key for a user": "/api/users/:user_id/ssh_keys/:id"
    },
    "hosts": {
      "List all hosts": "/api/hosts",
      "Show a host": "/api/hosts/:id",
      "Create a host": "/api/hosts",
      "Update a host": "/api/hosts/:id",
      "Delete a host": "/api/hosts/:id",
      "Get ENC values of host": "/api/hosts/:id/enc",
      "Get configuration status of host": "/api/hosts/:id/status",
      "Get status of host": "/api/hosts/:id/status/:type",
      "Get vm attributes of host": "/api/hosts/:id/vm_compute_attributes",
      "Disassociate the host from a VM": "/api/hosts/:id/disassociate",
      "Run a power operation on host": "/api/hosts/:id/power",
      "Fetch the status of whether the host is powered on or not. Supported hosts are VMs and physical hosts with BMCs": "/api/hosts/:id/power",
      "Boot host from specified device": "/api/hosts/:id/boot",
      "Upload facts for a host, creating the host if required": "/api/hosts/facts",
      "Rebuild orchestration config": "/api/hosts/:id/rebuild_config",
      "Preview rendered provisioning template content": "/api/hosts/:id/template/:kind"
    },
    "interfaces": {
      "List all interfaces for host": "/api/hosts/:host_id/interfaces",
      "Show an interface for host": "/api/hosts/:host_id/interfaces/:id",
      "Create an interface on a host": "/api/hosts/:host_id/interfaces",
      "Update a host's interface": "/api/hosts/:host_id/interfaces/:id",
      "Delete a host's interface": "/api/hosts/:host_id/interfaces/:id"
    },
    "config_templates": {
      "List provisioning templates": "/api/config_templates",
      "Show provisioning template details": "/api/config_templates/:id",
      "Create a provisioning template": "/api/config_templates",
      "Update a provisioning template": "/api/config_templates/:id",
      "Delete a provisioning template": "/api/config_templates/:id",
      "Update the default PXE menu on all configured TFTP servers": "/api/config_templates/build_pxe_default",
      "Clone a provision template": "/api/config_templates/:id/clone"
    },
    "home": {
      "Show available API links": "/api",
      "Show status": "/api/status"
    }
  }
}

Params

Param Name Description
location_id
Optional

Scope by locations

Validations:

  • Must be a Integer

organization_id
Optional

Scope by organizations

Validations:

  • Must be a Integer