Skip to main content
GET
List hardware presets

Authorizations

Authorization
string
header
required

An API key issued by Hive Compute support. See Authentication above for how to request one.

Query Parameters

cursor
string

Opaque cursor from a previous response's pagination.next. Omit to start at the first page.

size
integer
default:50

Number of items per page.

Required range: 1 <= x <= 200
region
enum<string>

Return only presets available in this region. Use a name from GET /regions.

Unlike the filter on GET /instances, this one also matches a raw datacenter location name, but only for locations that have no region mapping. Any other unrecognised value matches nothing and returns an empty page rather than an error.

Available options:
UAE,
FR,
US
sku
string

Return only presets with this SKU name, e.g. 8x-RTX-4090.

Match against SKU name, GPU model and datacenter location.

Maximum string length: 255
sort_field
enum<string>

Field to order by. Omitted, presets come back in a stable internal order, not by price.

Available options:
REGION,
LOCATION,
GPU,
CPU,
MEMORY,
STORAGE,
HOURLY_PRICE,
ID
sort_direction
enum<string>

Order direction, applied to sort_field. Defaults to ASC.

It is ignored unless sort_field is also set: with no sort field the result keeps its default order and this parameter has no effect.

Available options:
ASC,
DESC

Response

A page of presets.

data
object[]
pagination
object

Cursor pagination metadata.