Sign in

v2

latestOpenAPI 3.1.02026-08-07139158192.4 KB
Reservations

Amend a reservation's term, audience, or topology pin (platform admin)

patch/v1/nodes/{nodeId}/reservations/{id}

Path parameters

nodeIdstring required
idstring required

Request body

allowedOrgIdsstring[]

Replace the audience

endsAtstring

Move the term end. Empty string makes it open-ended.

reaffirmboolean

Re-pin to the node's current topology and reactivate (clears needs-review)

Response

OK

allowedOrgIdsstring[] required
contractRefstring
createdAtstring
endsAtstring

Absent = open-ended until cancelled

idstring required
nodeIdstring required
reasonstring
reservedUnitIdsstring[] required
startsAtstring required
status'pending' | 'active' | 'expired' | 'cancelled' | 'needs-review' required

needs-review means the node's GPU topology changed under the reservation: it grants nothing (and withholds its units from everyone) until an operator re-affirms it.

topologyGeninteger

Node topology generation this reservation was written against

updatedAtstring