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

# Changes to Create a rental

`POST /v2/on-demand/rentals`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 32 revisions.

- **2026-11-04** `ebe33157e243`: 1 breaking
- **2026-10-31** `194666d30bfc`: 1 warning, 1 info
- **2026-10-27** `dbf29b4ec8ea`: 1 info
- **2026-10-26** `6d718ca26d2b`: 15 breaking, 15 info
- **2026-10-21** `ae69ee1b2989`: 2 info
- **2026-10-19** `b242fec51e36`: 1 warning, 1 info
- **2026-10-16** `d6c9f6425ef6`: 1 breaking, 2 warning
- **2026-10-08** `788c6928f524`: 1 info

## Changes

- **2026-11-04** `ebe33157e243`: 1 breaking
  - the `termPeriodDays` request property's max was decreased to `30.00`
- **2026-10-31** `194666d30bfc`: 1 warning, 1 info
  - added the new `jp-east-2` enum value to the `region` response property for the response status `200`
  - added the new `jp-east-2` enum value to the request property `region/anyOf[subschema #1]/`
- **2026-10-27** `dbf29b4ec8ea`: 1 info
  - added the new optional request property `monitoringOptOut`
- **2026-10-26** `6d718ca26d2b`: 15 breaking, 15 info
  - the response property `convertToOnDemandOnExpiry` became nullable for the status `200`
  - the response property `createdBy/name` became nullable for the status `200`
  - the response property `createdBy/picture` became nullable for the status `200`
  - the response property `label` became nullable for the status `200`
  - the response property `managedCluster/anyOf[#/components/schemas/ManagedClusterRef]/label` became nullable for the status `200`
  - the response property `name` became nullable for the status `200`
  - the response property `nodes/items/cpuCount` became nullable for the status `200`
  - the response property `nodes/items/vcpuCount` became nullable for the status `200`
  - the response property `orgId` became nullable for the status `200`
  - the response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/gpuModel` became nullable for the status `200`
  - the response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/location` became nullable for the status `200`
  - the response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/nodes/items/hostname` became nullable for the status `200`
  - the response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/nodes/items/publicIp` became nullable for the status `200`
  - the response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/sshPort` became nullable for the status `200`
  - the response property `terminationReason` became nullable for the status `200`
  - response property `convertToOnDemandOnExpiry` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `createdBy/name` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `createdBy/picture` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `label` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `managedCluster/anyOf[#/components/schemas/ManagedClusterRef]/label` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `name` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `nodes/items/cpuCount` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `nodes/items/vcpuCount` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `orgId` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/gpuModel` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/location` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/nodes/items/hostname` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/nodes/items/publicIp` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `privateCluster/anyOf[#/components/schemas/PrivateCluster]/sshPort` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `terminationReason` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-10-21** `ae69ee1b2989`: 2 info
  - added the required property `supportsMultipleSshKeys` to the response with the `200` status
  - added the required property `supportsSshKeyUpdates` to the response with the `200` status
- **2026-10-19** `b242fec51e36`: 1 warning, 1 info
  - added the new `eu-north-9` enum value to the `region` response property for the response status `200`
  - added the new `eu-north-9` enum value to the request property `region/anyOf[subschema #1]/`
- **2026-10-16** `d6c9f6425ef6`: 1 breaking, 2 warning
  - the `termPeriodDays` request property type changed from `number` to `integer`
  - the `termPeriodDays` request property's max was set to `90.00`
  - the `termPeriodDays` request property's min was set to `1.00`
- **2026-10-08** `788c6928f524`: 1 info
  - endpoint added

---

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