Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
Reservations

Take released GPU units back into a reservation (platform admin)

Returns the named units to the reservation. Anything running on them is subject to termination by the node's owning org.

POST
/v1/nodes/{nodeId}/reservations/{id}/reclaim
AuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer vl_….

In: header

Path Parameters

nodeId*string
id*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/string/reclaim" \  -H "Content-Type: application/json" \  -d '{    "unitIds": [      "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 unit reclaim <node-id> <id> --unit-ids <unit-ids>