Reservations

Reserve a GPU

Reserve a GPU machine that is out of stock: GPU Cloud launches the server automatically as soon as it is back, before other customers (first come, first served per machine). A saved credit card is required (402 with error RESERVATION_CARD_REQUIRED and accountAction PAYMENT_REQUIRED carrying the card link), and the explicit authorization (consent). The automatic reload is not required: the answer carries onFundsExhausted, hibernationThresholdCad and, when the reload is off, autoReloadWarning. Nothing is charged when reserving; at launch, only the amount missing (first hour plus the hibernation threshold) is charged to the saved card.

post/reservations

Request

  • Base URL: https://gpucloud.ca/api
  • URL: https://gpucloud.ca/api/reservations
  • Auth: HTTP bearer

Request body

productIdstring required

Exact GPU machine (model and size), e.g. gpu-h100-x8.

sshKeyIdstring required
maxHourlyCadnumber required

Highest hourly price accepted (CAD): at least the current price, at most 5 times it.

validityDaysinteger
acceptAlternativeboolean

Launch an equivalent machine (same usage, at least the same GPU memory, never spot) when the exact one is not in stock.

namestring

Server name: letters, digits, space, dot, dash, underscore (63 at most).

templateIdstring
templateModelstring
consenttrue required

The user explicitly agreed: "I authorize GPU Cloud to launch this server as soon as it is available, to charge my saved card the amount needed if my balance is not enough, then to bill it by the hour under the terms."

consentVersionstring required
consentLang'fr' | 'en'
onFundsExhausted'HIBERNATE' | 'DELETE'

What happens to this hourly server when the balance reaches its threshold and no automatic reload brings it back. HIBERNATE: hibernated (its GPU place is kept, hourly hibernation fee), restarted as soon as the balance is back above the threshold, deleted after 12 hours without credit. DELETE: deleted at once, no hibernation fee, data lost. Machines that cannot be hibernated (spot) are always DELETE. Any other value: 400.

Example request

{
  "consentVersion": "2026-10-10"
}

Response

The reservation

onFundsExhausted'HIBERNATE' | 'DELETE'
allowedOnFundsExhaustedstring[]
hibernationThresholdCadnumber
autoReloadEnabledboolean
onFundsExhaustedNotestring

Example response

{
  "autoReloadWarning": {
    "message": "Without automatic reload, this server will be hibernated when your balance reaches $3.00 (its threshold), then deleted 12 h later without new credit. For an overnight job, turn on the automatic reload."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.