---
title: "Changes to Create a sandbox"
method: POST
path: "/sandboxes"
---

# Changes to Create a sandbox

`POST /sandboxes`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 12 revisions.

- **2026-11-04** `6ef35a11cefe`: 1 warning, 3 info
- **2026-10-30** `5a58ee38990e`: 1 info
- **2026-10-28** `c482e691c208`: 1 breaking, 4 info
- **2026-10-24** `9e0b37b16bb7`: 1 warning
- **2026-10-23** `e733493214f4`: 1 info

## Changes

- **2026-11-04** `6ef35a11cefe`: 1 warning, 3 info
  - added the new `idle_ttl_ended` enum value to the `end_reason/anyOf[subschema #1: SandboxEndReason]/` response property for the response status `201`
  - added the new optional request property `idle_ttl_seconds`
  - added the optional property `command` to the response with the `201` status
  - added the optional property `image` to the response with the `201` status
- **2026-10-30** `5a58ee38990e`: 1 info
  - added the new optional request property `resources/anyOf[subschema #1: SandboxResources]/shm_gb`
- **2026-10-28** `c482e691c208`: 1 breaking, 4 info
  - response property `ttl_ends_at` list-of-types was widened by adding types `null` to media type `application/json` of response `201`
  - added the new optional request property `egress`
  - added the new optional request property `idle`
  - the request property `ttl_seconds` became optional
  - request property `ttl_seconds` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-10-24** `9e0b37b16bb7`: 1 warning
  - added the new `platform_error` enum value to the `instances/anyOf[subschema #1]/items/failure_reason/anyOf[subschema #1: SandboxFailureReason]/` response property for the response status `201`
- **2026-10-23** `e733493214f4`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/hedra-labs/apis/hedra-api/docs/sandboxes/post.md) - [API](https://skmtc.dev/hedra-labs/apis/hedra-api.md) - [Page](https://skmtc.dev/hedra-labs/apis/hedra-api/changes/sandboxes/post)
