Reserve a running instance
Switches a running instance billed by the hour to a prepaid term of term_months that starts now, paid in full from credit. The price is the instance’s own hourly rate less that length’s discount, over the term’s hours (730 a month). Hourly billing stops at the switch: the hours run so far are billed once, at the hourly rate, up to it. Send expected_total_price (that option’s total_price): a different total is refused with 409 and details.reason price_changed, with the current total_price. An Idempotency-Key header is required: a retry with the same key returns the term already reserved (with the Idempotent-Replayed: true header) and charges nothing. Workspace owners and admins only, with an API key; an agent’s sign-in is refused (a person reserves in the dashboard). Reserving 3 months or more, or taking the workspace’s prepaid terms over $1,000, needs a verified identity (403). Refused with 402 without enough available credit (the balance less unbilled hourly use, this instance’s included), when the environment’s monthly budget has no room for the term, or while a payment on the workspace is disputed; and with 409 when the instance is not running, is already prepaid, is a job’s machine, is being stopped, or the length is not offered. From then on it is a prepaid term like one bought at launch: it can’t be stopped or terminated until it ends, its auto stop (max_runtime_minutes, idle_shutdown_minutes) is turned off, renewal opens 7 days before the end, and at the end the instance and its disk are deleted unless renewed. If the machine is lost, the unused time is returned as credit.
Authorizations
Use a Runcrate API key with the rc_live_* prefix as the bearer token. Create one at https://www.runcrate.ai/dashboard/api-keys.
Headers
Unique per reserve, 1 to 255 visible ASCII characters.
1 - 255Path Parameters
Body
Response
The term, running from now.