---
title: "Changes to Create a virtual machine rental"
method: POST
path: "/v2/alpha/on-demand/virtual-machine-rentals"
---

# Changes to Create a virtual machine rental

`POST /v2/alpha/on-demand/virtual-machine-rentals`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 14 revisions.

- **2026-09-25** `93d295b3f090` — 1 info
- **2026-09-22** `119b1ecbb0b2` — 4 breaking, 2 info
- **2026-09-17** `258ebb032c4a` — 1 warning, 1 info
- **2026-09-16** `1875a16896e1` — 1 warning, 2 info
- **2026-09-15** `35ac283ae04f` — 15 info
- **2026-09-08** `e16451dac634` — 1 breaking, 2 warning, 2 info
- **2026-09-03** `c5ba6c2504bb` — 2 info
- **2026-08-28** `6831853d7362` — 1 breaking, 1 warning, 3 info

## Changes

- **2026-09-25** `93d295b3f090` — 1 info
  - added the new optional request property `sshPublicKeyId`
- **2026-09-22** `119b1ecbb0b2` — 4 breaking, 2 info
  - removed the enum value `mock-region` of the request property `region`
  - the `orgId/anyOf[subschema #1]/` response's property type changed from no type to `string` for status `200`
  - the `rentalId` response's property type changed from no type to `string` for status `200`
  - removed the required property `externalId` from the response with the `200` status
  - added `subschema #1, subschema #2` to the `meta` response property `anyOf` list for the response status `200`
  - removed the `mock-region` enum value from the `region/anyOf[subschema #1]/` response property for the response status `200`
- **2026-09-17** `258ebb032c4a` — 1 warning, 1 info
  - added the new `eu-west-5` enum value to the `region/anyOf[subschema #1]/` response property for the response status `200`
  - added the new `eu-west-5` enum value to the request property `region`
- **2026-09-16** `1875a16896e1` — 1 warning, 2 info
  - added the new `us-southeast-3` enum value to the `region/anyOf[subschema #1]/` response property for the response status `200`
  - api tag `virtual-machine-rentals` added
  - added the new `us-southeast-3` enum value to the request property `region`
- **2026-09-15** `35ac283ae04f` — 15 info
  - added the optional property `providerData/benchmark` to the response with the `200` status
  - added the optional property `providerData/customPorts` to the response with the `200` status
  - added the optional property `providerData/extra` to the response with the `200` status
  - added the optional property `providerData/gpuFormFactor` to the response with the `200` status
  - added the optional property `providerData/gpuModel` to the response with the `200` status
  - added the optional property `providerData/location` to the response with the `200` status
  - added the optional property `providerData/networkType` to the response with the `200` status
  - added the optional property `providerData/nodeNetworking` to the response with the `200` status
  - added the optional property `providerData/nodes` to the response with the `200` status
  - added the optional property `providerData/portForwards` to the response with the `200` status
  - added the optional property `providerData/sshNetworking` to the response with the `200` status
  - added the optional property `providerData/sshPort` to the response with the `200` status
  - added the optional property `providerData/sshUser` to the response with the `200` status
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10, subschema #11` from the `providerData` response property `oneOf` list for the response status `200`
  - added the required property `providerData/resources` to the response with the `200` status
- **2026-09-08** `e16451dac634` — 1 breaking, 2 warning, 2 info
  - added `subschema #9` to the `providerData` response property `oneOf` list for the response status `200`
  - added the new `rtx-6000-pro` enum value to the `gpuType` response property for the response status `200`
  - added the new `us-east-3` enum value to the `region/anyOf[subschema #1]/` response property for the response status `200`
  - added the new `rtx-6000-pro` enum value to the request property `gpuType`
  - added the new `us-east-3` enum value to the request property `region`
- **2026-09-03** `c5ba6c2504bb` — 2 info
  - api operation id `ondemand-createVirtualMachineRental` removed and replaced with `ondemand-createVirtualMachineRental-legacy`
  - endpoint deprecated
- **2026-08-28** `6831853d7362` — 1 breaking, 1 warning, 3 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10` to the `providerData` response property `oneOf` list for the response status `200`
  - added the new `ca-east-3` enum value to the `region/anyOf[subschema #1]/` response property for the response status `200`
  - added the new `ca-east-3` enum value to the request property `region`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10` from the `providerData` response property `oneOf` list for the response status `200`
  - added the required property `managedK8sClusterId` to the response with the `200` status

---

[Operation](https://skmtc.dev/hyperbolic/apis/castle-api/docs/v2/alpha/on-demand/virtual-machine-rentals/post.md) · [API](https://skmtc.dev/hyperbolic/apis/castle-api.md) · [Page](https://skmtc.dev/hyperbolic/apis/castle-api/changes/v2/alpha/on-demand/virtual-machine-rentals/post)