---
title: "Changes to Create and start instance"
method: POST
path: "/instances"
---

# Changes to Create and start instance

`POST /instances`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 27 of 51 revisions.

- **2026-09-02** `f786ee519143`: 1 info
- **2026-09-02** `b2914ae67478`: 1 warning
- **2026-09-02** `36d620751895`: 1 info
- **2026-08-21** `b00eacfe26b2`: 1 warning, 4 info
- **2026-06-09** `796cd163e0f1`: 4 info
- **2026-05-18** `9716796b73b2`: 3 info
- **2026-05-18** `06a18bfe794c`: 3 info
- **2026-05-18** `722eb2b221c9`: 1 info
- **2026-05-14** `d8b4e555ae63`: 1 warning
- **2026-05-12** `722eb2b221c9`: 3 info
- **2026-04-17** `c6da5deb317c`: 2 info
- **2026-04-07** `52bc64e89c84`: 2 info
- **2026-03-23** `8251e13b6a8e`: 2 info
- **2026-03-19** `84cb170b2dc7`: 2 info
- **2026-03-09** `12f78ec90ae6`: 1 warning
- **2026-03-09** `d3b8f05f7a0f`: 2 warning, 2 info
- **2026-03-07** `48572ed07140`: 2 breaking, 1 warning, 2 info
- **2026-03-02** `ec9459bfe289`: 1 warning, 1 info
- **2026-02-26** `d5ce7bbc5163`: 1 info
- **2026-02-13** `fa1e2bdf81a0`: 4 info
- **2026-02-13** `517b6ad15b7d`: 2 info
- **2026-02-11** `0541294848c0`: 1 warning, 1 info
- **2026-01-30** `cf9805637aaf`: 1 info
- **2026-01-23** `4f6187089a62`: 2 info
- **2026-01-16** `e052ac01c788`: 2 info
- **2026-01-05** `6e0a4efd1508`: 6 info
- **2025-12-23** `cfdd18a303e2`: 2 info

## Changes

- **2026-09-02** `f786ee519143`: 1 info
  - added the optional property `gpu/device_path` to the response with the `201` status
- **2026-09-02** `b2914ae67478`: 1 warning
  - removed the optional property `gpu/device_path` from the response with the `201` status
- **2026-09-02** `36d620751895`: 1 info
  - added the optional property `gpu/device_path` to the response with the `201` status
- **2026-08-21** `b00eacfe26b2`: 1 warning, 4 info
  - added the new `qemu-microvm` enum value to the `hypervisor` response property for the response status `201`
  - added the new optional request property `expires_at`
  - added the new optional request property `ttl`
  - added the new `qemu-microvm` enum value to the request property `hypervisor`
  - added the required property `expires_at` to the response with the `201` status
- **2026-06-09** `796cd163e0f1`: 4 info
  - added the new optional request property `platform`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the optional property `platform` to the response with the `201` status
- **2026-05-18** `9716796b73b2`: 3 info
  - added the new optional request property `restart_policy`
  - added the optional property `restart_policy` to the response with the `201` status
  - added the optional property `restart_status` to the response with the `201` status
- **2026-05-18** `06a18bfe794c`: 3 info
  - added the new optional request property `health_check`
  - added the optional property `health_check` to the response with the `201` status
  - added the optional property `health_status` to the response with the `201` status
- **2026-05-18** `722eb2b221c9`: 1 info
  - removed the `Template` enum value from the `state` response property for the response status `201`
- **2026-05-14** `d8b4e555ae63`: 1 warning
  - added the new `Template` enum value to the `state` response property for the response status `201`
- **2026-05-12** `722eb2b221c9`: 3 info
  - added the optional property `current_phase` to the response with the `201` status
  - added the optional property `current_phase_since` to the response with the `201` status
  - added the optional property `phase_durations_ms` to the response with the `201` status
- **2026-04-17** `c6da5deb317c`: 2 info
  - added the new optional request property `snapshot_policy/standby_compression_delay`
  - added the optional property `snapshot_policy/standby_compression_delay` to the response with the `201` status
- **2026-04-07** `52bc64e89c84`: 2 info
  - added the new optional request property `auto_standby`
  - added the optional property `auto_standby` to the response with the `201` status
- **2026-03-23** `8251e13b6a8e`: 2 info
  - added the new optional request property `snapshot_policy`
  - added the optional property `snapshot_policy` to the response with the `201` status
- **2026-03-19** `84cb170b2dc7`: 2 info
  - added the new optional request property `credentials`
  - added the new optional request property `network/egress`
- **2026-03-09** `12f78ec90ae6`: 1 warning
  - added the new `Initializing` enum value to the `state` response property for the response status `201`
- **2026-03-09** `d3b8f05f7a0f`: 2 warning, 2 info
  - removed the request property `metadata`
  - removed the optional property `metadata` from the response with the `201` status
  - added the new optional request property `tags`
  - added the optional property `tags` to the response with the `201` status
- **2026-03-07** `48572ed07140`: 2 breaking, 1 warning, 2 info
  - added the pattern `^[A-Za-z0-9 _.:/=+@-]*$` to the request property `metadata/additionalProperties/`
  - added 'propertyNames' constraint to the request property `metadata`
  - the `metadata/additionalProperties/` request property's maxLength was set to `256`
  - the `metadata/additionalProperties/` response's property pattern `^[A-Za-z0-9 _.:/=+@-]*$` was added for the status `201`
  - added 'propertyNames' constraint to the `metadata` response property for the status `201`
- **2026-03-02** `ec9459bfe289`: 1 warning, 1 info
  - added the new `firecracker` enum value to the `hypervisor` response property for the response status `201`
  - added the new `firecracker` enum value to the request property `hypervisor`
- **2026-02-26** `d5ce7bbc5163`: 1 info
  - the `hotplug_size` request property default value `3GB` was removed
- **2026-02-13** `fa1e2bdf81a0`: 4 info
  - added the new optional request property `cmd`
  - added the new optional request property `entrypoint`
  - added the optional property `exit_code` to the response with the `201` status
  - added the optional property `exit_message` to the response with the `201` status
- **2026-02-13** `517b6ad15b7d`: 2 info
  - added the new optional request property `metadata`
  - added the optional property `metadata` to the response with the `201` status
- **2026-02-11** `0541294848c0`: 1 warning, 1 info
  - added the new `vz` enum value to the `hypervisor` response property for the response status `201`
  - added the new `vz` enum value to the request property `hypervisor`
- **2026-01-30** `cf9805637aaf`: 1 info
  - added the non-success response with the status `409`
- **2026-01-23** `4f6187089a62`: 2 info
  - added the new optional request property `skip_guest_agent`
  - added the new optional request property `skip_kernel_headers`
- **2026-01-16** `e052ac01c788`: 2 info
  - added the new optional request property `gpu`
  - added the optional property `gpu` to the response with the `201` status
- **2026-01-05** `6e0a4efd1508`: 6 info
  - added the new optional request property `disk_io_bps`
  - added the new optional request property `network/bandwidth_download`
  - added the new optional request property `network/bandwidth_upload`
  - added the optional property `disk_io_bps` to the response with the `201` status
  - added the optional property `network/bandwidth_download` to the response with the `201` status
  - added the optional property `network/bandwidth_upload` to the response with the `201` status
- **2025-12-23** `cfdd18a303e2`: 2 info
  - added the new optional request property `hypervisor`
  - added the optional property `hypervisor` to the response with the `201` status

---

[Operation](https://skmtc.dev/kernel/apis/hypeman-api/docs/instances/post.md) - [API](https://skmtc.dev/kernel/apis/hypeman-api.md) - [Page](https://skmtc.dev/kernel/apis/hypeman-api/changes/instances/post)