Reservations
Reserve GPU units on a node for a set of orgs (platform admin)
Grants exclusive placement rights over specific GPU units for a term. Reserved units disappear from every other org's catalog and cannot be placed on by them. Overlap with an existing reservation is rejected atomically.
Authorization
apiKey AuthorizationBearer <token>
OpenRelay API key. Send it as Authorization: Bearer vl_….
In: header
Path Parameters
nodeId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/nodes/string/reservations" \ -H "Content-Type: application/json" \ -d '{ "unitIds": [ "string" ], "allowedOrgIds": [ "string" ] }'{
"id": "string",
"nodeId": "string",
"reservedUnitIds": [
"string"
],
"allowedOrgIds": [
"string"
],
"startsAt": "string",
"endsAt": "string",
"status": "pending",
"topologyGen": 0,
"contractRef": "string",
"reason": "string",
"createdAt": "string",
"updatedAt": "string"
}{
"error": "string",
"code": "string"
}{
"error": "string",
"code": "string"
}{
"error": "string",
"code": "string"
}{
"error": "string",
"code": "string"
}{
"error": "string",
"code": "string"
}Command line
The orl CLI wraps this endpoint:
orl reservations node create <node-id> --allowed-org-ids <allowed-org-ids> --unit-ids <unit-ids>