--- title: "Changes to Create a Devbox." method: POST path: "/v1/devboxes" --- # Changes to Create a Devbox. `POST /v1/devboxes` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 29 of 50 revisions. - **2026-08-20** `e9dc776053e4` — 2 info - **2026-07-22** `fe489479c0aa` — 2 warning, 1 info - **2026-07-10** `7715c368e070` — 1 warning - **2026-06-09** `b4ffb9a8aff3` — 2 info - **2026-06-08** `078a027e147f` — 2 warning - **2026-05-27** `d3ddb452754c` — 52 breaking, 20 warning, 29 info - **2026-04-15** `406ebae7a9b8` — 1 info - **2026-04-13** `5b536a11a713` — 2 info - **2026-04-10** `f0eb12cf4df4` — 1 warning - **2026-04-09** `a1c7e69cbbf7` — 1 breaking, 6 info - **2026-04-03** `b0d4f639559e` — 1 warning - **2026-04-01** `c33fa67077f6` — 2 info - **2026-03-25** `c576eb67f119` — 2 breaking, 2 info - **2026-03-25** `efb88e3669a1` — 2 info - **2026-02-27** `132ed1607165` — 2 breaking - **2026-02-26** `fa81aa937935` — 1 info - **2026-02-25** `dd0f43e15cb6` — 2 info - **2026-02-05** `15b7fd06098d` — 1 info - **2026-01-30** `b493cadf2e3b` — 1 warning, 1 info - **2026-01-30** `debd1f9a9d59` — 4 info - **2026-01-20** `5bbc26893c51` — 1 warning - **2026-01-19** `eac4defbf398` — 1 warning, 1 info - **2026-01-19** `8ebd9dbfacb1` — 1 warning, 3 info - **2025-12-13** `370a5d676ff0` — 1 breaking, 1 warning, 5 info - **2025-11-25** `0dd27c6877ed` — 3 info - **2025-11-19** `5f33221208c1` — 1 breaking, 2 info - **2025-10-02** `6b65a42b7440` — 1 info - **2025-09-30** `9b2e136aedff` — 3 info - **2025-09-29** `1749c364b895` — 1 info ## Changes - **2026-08-20** `e9dc776053e4` — 2 info - added the new `pi_json` enum value to the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol/anyOf[#/components/schemas/BrokerMountProtocol]/` - added the optional property `state_transitions/items/failure_reason` to the response with the `200` status - **2026-07-22** `fe489479c0aa` — 2 warning, 1 info - added the new `queued` enum value to the `state_transitions/items/status` response property for the response status `200` - added the new `queued` enum value to the `status` response property for the response status `200` - added the new `codex_json` enum value to the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol/anyOf[#/components/schemas/BrokerMountProtocol]/` - **2026-07-10** `7715c368e070` — 1 warning - removed the request property `repo_connection_id` - **2026-06-09** `b4ffb9a8aff3` — 2 info - added the new optional request property `launch_parameters/anyOf[#/components/schemas/LaunchParameters]/provisioning_tier` - added the optional property `launch_parameters/provisioning_tier` to the response with the `200` status - **2026-06-08** `078a027e147f` — 2 warning - added the new `scheduled` enum value to the `state_transitions/items/status` response property for the response status `200` - added the new `scheduled` enum value to the `status` response property for the response status `200` - **2026-05-27** `d3ddb452754c` — 52 breaking, 20 warning, 29 info - the request property `blueprint_id` became not nullable - the request property `blueprint_name` became not nullable - the request property `code_mounts` became not nullable - the request property `code_mounts/items/git_ref` became not nullable - the request property `code_mounts/items/install_command` became not nullable - the request property `code_mounts/items/token` became not nullable - the request property `entrypoint` became not nullable - the request property `environment_variables` became not nullable - the request property `file_mounts` became not nullable - the request property `gateways` became not nullable - the request property `launch_parameters` became not nullable - the request property `mcp` became not nullable - the request property `metadata` became not nullable - the request property `mounts` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/AgentMount]/agent_id` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/AgentMount]/agent_name` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/AgentMount]/agent_path` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/AgentMount]/auth_token` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/agent_binary` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/launch_args` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/working_directory` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/CodeMount]/git_ref` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/CodeMount]/install_command` became not nullable - the request property `mounts/items/oneOf[#/components/schemas/CodeMount]/token` became not nullable - the request property `name` became not nullable - the request property `repo_connection_id` became not nullable - the request property `secrets` became not nullable - the request property `snapshot_id` became not nullable - the request property `tunnel` became not nullable - removed the enum value `acp` of the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` - removed the enum value `claude_json` of the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` - the `launch_parameters` request property type/format changed from `object`/`` to ``/`` - the `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` request property type/format changed from `string`/`` to ``/`` - the `tunnel` request property type/format changed from `object`/`` to ``/`` - the `failure_reason` response's property type/format changed from `string`/`` to ``/`` for status `200` - the `launch_parameters/after_idle` response's property type/format changed from `object`/`` to ``/`` for status `200` - the `launch_parameters/architecture` response's property type/format changed from `string`/`` to ``/`` for status `200` - the `launch_parameters/lifecycle` response's property type/format changed from `object`/`` to ``/`` for status `200` - the `launch_parameters/resource_size_request` response's property type/format changed from `string`/`` to ``/`` for status `200` - …61 more - **2026-04-15** `406ebae7a9b8` — 1 info - added the new optional request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/working_directory` - **2026-04-13** `5b536a11a713` — 2 info - added the new optional request property `launch_parameters/lifecycle/resume_triggers/axon_event` - added the optional property `launch_parameters/lifecycle/resume_triggers/axon_event` to the response with the `200` status - **2026-04-10** `f0eb12cf4df4` — 1 warning - added the new `ttl_expired` enum value to the `shutdown_reason` response property for the response status `200` - **2026-04-09** `a1c7e69cbbf7` — 1 breaking, 6 info - removed the enum value `codex_app_server` of the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` - added the new optional request property `code_mounts/items/git_ref` - added the new optional request property `launch_parameters/lifecycle` - added the new optional request property `mounts/items/oneOf[#/components/schemas/CodeMount]/git_ref` - added the optional property `launch_parameters/lifecycle` to the response with the `200` status - removed the `browser_usage` enum value from the `capabilities/items/` response property for the response status `200` - removed the `computer_usage` enum value from the `capabilities/items/` response property for the response status `200` - **2026-04-03** `b0d4f639559e` — 1 warning - added the new `health_check_failed` enum value to the `failure_reason` response property for the response status `200` - **2026-04-01** `c33fa67077f6` — 2 info - added the new optional request property `tunnel/wake_on_http` - added the required property `tunnel/wake_on_http` to the response with the `200` status - **2026-03-25** `c576eb67f119` — 2 breaking, 2 info - removed the enum value `claude` of the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` - removed the enum value `codex` of the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` - added the new `claude_json` enum value to the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` - added the new `codex_app_server` enum value to the request property `mounts/items/oneOf[#/components/schemas/BrokerMount]/protocol` - **2026-03-25** `efb88e3669a1` — 2 info - added `broker_mount` discriminator mapping keys to the `mounts/items/` request property - added `#/components/schemas/BrokerMount` to the `mounts/items/` request property `oneOf` list - **2026-02-27** `132ed1607165` — 2 breaking - the `mcp` request property type/format changed from `array`/`` to `object`/`` - the `mcp_specs` response's property type/format changed from `array`/`` to `object`/`` for status `200` - **2026-02-26** `fa81aa937935` — 1 info - added the optional property `mcp_specs` to the response with the `200` status - **2026-02-25** `dd0f43e15cb6` — 2 info - added the new optional request property `tunnel/http_keep_alive` - added the required property `tunnel/http_keep_alive` to the response with the `200` status - **2026-02-05** `15b7fd06098d` — 1 info - added the new optional request property `mcp` - **2026-01-30** `b493cadf2e3b` — 1 warning, 1 info - added the new `open` enum value to the `tunnel/auth_mode` response property for the response status `200` - removed the `public_` enum value from the `tunnel/auth_mode` response property for the response status `200` - **2026-01-30** `debd1f9a9d59` — 4 info - added the new optional request property `gateways` - added the new optional request property `tunnel` - added the optional property `gateway_specs` to the response with the `200` status - added the optional property `tunnel` to the response with the `200` status - **2026-01-20** `5bbc26893c51` — 1 warning - removed the optional property `network_policy_id` from the response with the `200` status - **2026-01-19** `eac4defbf398` — 1 warning, 1 info - removed the request property `network_policy_id` - added the optional property `network_policy_id` to the response with the `200` status - **2026-01-19** `8ebd9dbfacb1` — 1 warning, 3 info - added the new `scoring_validation` enum value to the `initiator_type` response property for the response status `200` - added the new optional request property `launch_parameters/network_policy_id` - added the new optional request property `network_policy_id` - added the optional property `launch_parameters/network_policy_id` to the response with the `200` status - **2025-12-13** `370a5d676ff0` — 1 breaking, 1 warning, 5 info - removed `#/components/schemas/ObjectMountParameters, #/components/schemas/AgentMountParameters, #/components/schemas/CodeMountParameters, #/components/schemas/FileMountParameters` from the `mounts/items/` request property `oneOf` list - removed the request property `code_mounts/items/type` - mapped value for discriminator key `agent_mount` changed from `#/components/schemas/AgentMountParameters` to `#/components/schemas/AgentMount` for `mounts/items/` request property - mapped value for discriminator key `code_mount` changed from `#/components/schemas/CodeMountParameters` to `#/components/schemas/CodeMount` for `mounts/items/` request property - mapped value for discriminator key `file_mount` changed from `#/components/schemas/FileMountParameters` to `#/components/schemas/FileMount` for `mounts/items/` request property - mapped value for discriminator key `object_mount` changed from `#/components/schemas/ObjectMountParameters` to `#/components/schemas/ObjectMount` for `mounts/items/` request property - added `#/components/schemas/ObjectMount, #/components/schemas/AgentMount, #/components/schemas/CodeMount, #/components/schemas/FileMount` to the `mounts/items/` request property `oneOf` list - **2025-11-25** `0dd27c6877ed` — 3 info - added the new required request property `code_mounts/items/type` with a default value - added `code_mount, file_mount` discriminator mapping keys to the `mounts/items/` request property - added `#/components/schemas/CodeMountParameters, #/components/schemas/FileMountParameters` to the `mounts/items/` request property `oneOf` list - **2025-11-19** `5f33221208c1` — 1 breaking, 2 info - added the new required request property `mounts/items/oneOf[#/components/schemas/AgentMountParameters]/agent_name` - added the new optional request property `mounts/items/oneOf[#/components/schemas/AgentMountParameters]/auth_token` - the request property `mounts/items/oneOf[#/components/schemas/AgentMountParameters]/agent_id` became nullable - **2025-10-02** `6b65a42b7440` — 1 info - added the new optional request property `mounts` - **2025-09-30** `9b2e136aedff` — 3 info - added the optional property `initiator_id` to the response with the `200` status - added the optional property `initiator_type` to the response with the `200` status - the response property `end_time_ms` became required for the status `200` - **2025-09-29** `1749c364b895` — 1 info - removed the `language_server` enum value from the `capabilities/items/` response property for the response status `200` --- [Operation](https://skmtc.dev/runloopai/apis/runloop-api/docs/v1/devboxes/post.md) · [API](https://skmtc.dev/runloopai/apis/runloop-api.md) · [Page](https://skmtc.dev/runloopai/apis/runloop-api/changes/v1/devboxes/post)