Oxide

Oxide System/hardware API

These operations pertain to hardware inventory and management. Racks are the unit of expansion of an Oxide deployment. Racks are in turn composed of sleds, switches, power supplies, and a cabled backplane.

GitHub OpenAPI
Business capability
IT Infrastructure Management BC-600.50

Operations 20

PUT /v1/system/hardware/disk-adoption-request Enable adoption of a physical disk for general use #
DELETE /v1/system/hardware/disk-adoption-request/{physical_disk_adoption_req_id} Disable adoption of a physical disk for general use #
GET /v1/system/hardware/disk-adoption-requests List physical disk adoption requests #
GET /v1/system/hardware/disks List physical disks #
GET /v1/system/hardware/disks/{disk_id} Get physical disk #
GET /v1/system/hardware/disks-unadopted List physical disks that have not yet been adopted for use #
GET /v1/system/hardware/racks List racks #
GET /v1/system/hardware/racks/{rack_id} Fetch rack #
GET /v1/system/hardware/sleds List sleds #
GET /v1/system/hardware/sleds/{sled_id} Fetch sled #
GET /v1/system/hardware/sleds/{sled_id}/disks List physical disks attached to sleds #
GET /v1/system/hardware/sleds/{sled_id}/instances List instances running on given sled #
PUT /v1/system/hardware/sleds/{sled_id}/provision-policy Set sled provision policy #
GET /v1/system/hardware/sleds-uninitialized List uninitialized sleds #
GET /v1/system/hardware/switch-port List switch ports #
POST /v1/system/hardware/switch-port/{port}/settings Apply switch port settings #
DELETE /v1/system/hardware/switch-port/{port}/settings Clear switch port settings #
GET /v1/system/hardware/switch-port/{port}/status Get switch port status #
GET /v1/system/hardware/switches List switches #
GET /v1/system/hardware/switches/{switch_id} Fetch switch #

Documentation

📖
Documentation
https://docs.oxide.computer/api
📖
APIReference
https://docs.oxide.computer/api
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/oxide-computer/refs/heads/main/authentication/oxide-computer-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/oxide-computer/refs/heads/main/openapi/oxide-computer-system-hardware-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/oxide-computer/refs/heads/main/errors/oxide-computer-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/oxide-computer/refs/heads/main/data-model/oxide-computer-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/oxide-computer/refs/heads/main/asyncapi/oxide-computer-alerts-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/oxide-computer-system-hardware-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

oxide-computer-system-hardware-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Oxide Region System/hardware API
  description: API for interacting with the Oxide control plane
  contact:
    url: https://oxide.computer
    email: api@oxide.computer
  version: 2026081901.0.0
tags:


# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oxide-computer/refs/heads/main/openapi/oxide-computer-system-hardware-api-openapi.yml