How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Packet Host HardwareReservations API

Hardware Reservation Management. Check out the product docs to learn more about [Reserved Hardware](https://metal.equinix.com/developers/docs/deploy/reserved/).

Packet Host HardwareReservations API is one of 40 APIs that Packet Host publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include HardwareReservations. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 4 operations across 4 paths, and defines 58 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://api.equinix.com/metal/v1.

4 operations 4 paths 58 schemas 2 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.equinix.com/metal/v1
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Packet Host HardwareReservations API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Auth-Token (x_auth_token). By default, every request must be authenticated.

  • x_auth_token — HTTP header containing the User or Project API key that will be used to authenticate the request.

Paths & Operations 4

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

HardwareReservations 4

Hardware Reservation Management. Check out the product docs to learn more about [Reserved Hardware](https://metal.equinix.com/developers/docs/deploy/reserved/).

GET
/hardware-reservations/{id}
Retrieve a hardware reservation
findHardwareReservationById 3 params → 200401403404
POST
/hardware-reservations/{id}/activate
Activate a spare hardware reservation
activateHardwareReservation 3 params body → 201401403404
POST
/hardware-reservations/{id}/move
Move a hardware reservation
moveHardwareReservation 3 params body → 201401403404
GET
/projects/{id}/hardware-reservations
Retrieve all hardware reservations for a given project
findProjectHardwareReservations 8 params → 200401403404

Schemas 58

The contract defines 58 schemas that model the data the API accepts and returns. The most detailed are Device (43 properties), IPAssignment (20 properties), Project (19 properties), Organization (17 properties). Each schema is shown below with its type and property counts.

Project
object
19 properties
Device_state
string
The current state the instance is in. When an instance is initially created it will be in the queued state until it is picked up by the provisioner. Once provi…
Plan_specs_cpus_inner
object
2 properties
Mount
object
4 properties
IPAssignment
object
20 properties
HardwareReservation
object
14 properties
activateHardwareReservation_request
object
1 property
Address
object
7 properties 3 required
Error
object
Error responses are included with 4xx and 5xx HTTP responses from the API service. Either "error" or "errors" will be set.
2 properties
VirtualNetwork
object
13 properties
MetalGateway_state
string
The current state of the Metal Gateway. 'Ready' indicates the gateway record has been configured, but is currently not active on the network. 'Active' indicate…
Meta
object
8 properties
ParentBlock
object
4 properties
Plan_available_in_inner
object
2 properties
moveHardwareReservation_request
object
1 property
Event
object
10 properties
Device_metro
IPAssignment_state
string
Only set when this is a Metal Gateway Elastic IP Assignment. Describes the current configuration state of this IP on the network.
Port_network_type
string
Composite network type of the bond
Plan_type
string
The plan type
Plan
object
14 properties
Metro
object
4 properties
Plan_specs
object
5 properties
Port_type
string
Type is either "NetworkBondPort" for bond ports or "NetworkPort" for bondable ethernet ports
Partition
object
3 properties
Device
object
43 properties
findProjectHardwareReservations_provisionable_parameter
string
Disk
object
3 properties
OperatingSystem
object
11 properties
UserLite
object
10 properties 2 required
Project_type
string
The type of the project. Projects of type vmce are part of an in development feature and not available to all customers.
Coordinates
object
2 properties
Plan_specs_features
object
3 properties
Plan_specs_memory
object
1 property
Storage
object
3 properties
Device_project_lite
Port
object
Port is a hardware port associated with a reserved or instantiated hardware device.
10 properties
PortData
object
2 properties
HardwareReservationList
object
2 properties
Plan_deployment_types_inner
string
Device_actions_inner
object
2 properties
Plan_available_in_metros_inner
object
2 properties
Facility
object
7 properties
Filesystem
object
1 property
IPAssignment_type
string
Href
object
1 property 1 required
BondPortData
object
2 properties
Device_created_by
Organization
object
17 properties
Raid
object
3 properties
Facility_features_inner
string
IPAssignment_metro
Plan_specs_nics_inner
object
2 properties
Plan_specs_drives_inner
object
4 properties
findProjectHardwareReservations_state_parameter
string
MetalGatewayLite
object
7 properties
Plan_available_in_inner_price
object
1 property
Plan_specs_drives_inner_category
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

packet-host-hardwarereservations-api-openapi.yml Raw ↑

Other APIs Packet Host publishes across the network.

Packet Host Authentication API
Packet Host Batches API
Packet Host BGP API
Packet Host Capacity API
Packet Host Console Log Details API
Packet Host Devices API
Packet Host Emails API
Packet Host Events API
Packet Host Facilities API
Packet Host Firmware Sets API
Packet Host Incidents API
Packet Host Interconnections API
Where this information came from

This is an independent, third-party profile of Packet Host HardwareReservations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.