--- title: "Changes to CreateEnvironmentFromProject" method: POST path: "/gitpod.v1.EnvironmentService/CreateEnvironmentFromProject" --- # Changes to CreateEnvironmentFromProject `POST /gitpod.v1.EnvironmentService/CreateEnvironmentFromProject` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 12 of 18 revisions. - **2026-07-30** `44d50c2ac284` — 3 warning, 11 info - **2026-04-02** `dabc0ff98cd7` — 23 info - **2026-02-18** `1923b5d38655` — 2 info - **2026-02-11** `b97dcde84128` — 4 warning, 9 info - **2026-01-21** `2423c089f280` — 2 breaking, 4 info - **2025-12-15** `d62ef4b9187c` — 3 breaking, 6 warning, 18 info - **2025-06-10** `ca9a49ac7fbb` — 1 warning, 7 info - **2025-02-21** `3655d5ad0ac3` — 2 breaking, 1 warning, 16 info - **2025-02-18** `cd6a05ae99d2` — 1 warning - **2025-02-18** `bef0e79f204c` — 3 info - **2025-02-18** `f6598ab5d682` — 1 info - **2025-02-14** `27f7bd641de1` — 1 breaking, 1 info ## Changes - **2026-07-30** `44d50c2ac284` — 3 warning, 11 info - removed the request property `spec/secrets/items/credentialProxy/format` - removed the optional property `environment/spec/secrets/items/credentialProxy/format` from the response with the `200` status - added the new `ENVIRONMENT_ROLE_BASE_SNAPSHOT_BUILD` enum value to the `environment/metadata/role` response property for the response status `200` - added the new optional request property `spec/kernelControlsConfig/veto/file` - added the new optional request property `spec/secrets/items/sourceDetails` - added the new optional request property `spec/securityPolicyId` - request property `spec/kernelControlsConfig/veto/exec/denyBlockDevices` deprecated - added the optional property `environment/metadata/pinnedByCreator` to the response with the `200` status - added the optional property `environment/spec/kernelControlsConfig/veto/file` to the response with the `200` status - added the optional property `environment/spec/secrets/items/sourceDetails` to the response with the `200` status - added the optional property `environment/spec/securityPolicyId` to the response with the `200` status - added the optional property `environment/status/codex` to the response with the `200` status - added the optional property `environment/status/content/git/changedFiles/items/oldPath` to the response with the `200` status - response property `environment/spec/kernelControlsConfig/veto/exec/denyBlockDevices` deprecated - **2026-04-02** `dabc0ff98cd7` — 23 info - added the new optional request property `annotations` - added the new optional request property `sessionId` - added the new optional request property `spec/kernelControlsConfig/bpfDebugLevel` - added the new optional request property `spec/kernelControlsConfig/veto/exec/denyBlockDevices` - added the new optional request property `spec/kernelControlsConfig/veto/exec/resolveBareNames` - added the new optional request property `spec/kernelControlsConfig/veto/exec/untouchable` - added the new optional request property `spec/kernelControlsConfig/veto/exec/watch` - added the new optional request property `spec/machine/preferDualDisk` - added the new optional request property `spec/ports/items/authNonce` - added the new optional request property `spec/secrets/items/credentialProxy` - added the optional property `environment/metadata/lockdownAt` to the response with the `200` status - added the optional property `environment/metadata/sessionId` to the response with the `200` status - added the optional property `environment/spec/kernelControlsConfig/bpfDebugLevel` to the response with the `200` status - added the optional property `environment/spec/kernelControlsConfig/veto/exec/denyBlockDevices` to the response with the `200` status - added the optional property `environment/spec/kernelControlsConfig/veto/exec/resolveBareNames` to the response with the `200` status - added the optional property `environment/spec/kernelControlsConfig/veto/exec/untouchable` to the response with the `200` status - added the optional property `environment/spec/kernelControlsConfig/veto/exec/watch` to the response with the `200` status - added the optional property `environment/spec/machine/preferDualDisk` to the response with the `200` status - added the optional property `environment/spec/ports/items/authNonce` to the response with the `200` status - added the optional property `environment/spec/secrets/items/credentialProxy` to the response with the `200` status - added the optional property `environment/status/environmentUrls/vmLiveUsage` to the response with the `200` status - added the optional property `environment/status/machine/dualDisk` to the response with the `200` status - removed the `PRINCIPAL_AGENT_EXECUTION` enum value from the `environment/metadata/creator/principal` response property for the response status `200` - **2026-02-18** `1923b5d38655` — 2 info - added the new optional request property `spec/kernelControlsConfig/veto/exec/action` - added the optional property `environment/spec/kernelControlsConfig/veto/exec/action` to the response with the `200` status - **2026-02-11** `b97dcde84128` — 4 warning, 9 info - added the new `ADMISSION_LEVEL_CREATOR_ONLY` enum value to the `environment/spec/admission` response property for the response status `200` - added the new `ADMISSION_LEVEL_CREATOR_ONLY` enum value to the `environment/spec/ports/items/admission` response property for the response status `200` - added the new `ADMISSION_LEVEL_ORGANIZATION` enum value to the `environment/spec/admission` response property for the response status `200` - added the new `ADMISSION_LEVEL_ORGANIZATION` enum value to the `environment/spec/ports/items/admission` response property for the response status `200` - added the new optional request property `name` - added the new optional request property `spec/kernelControlsConfig` - added the new optional request property `spec/secrets/items/scope` - added the new `ADMISSION_LEVEL_CREATOR_ONLY` enum value to the request property `spec/admission` - added the new `ADMISSION_LEVEL_CREATOR_ONLY` enum value to the request property `spec/ports/items/admission` - added the new `ADMISSION_LEVEL_ORGANIZATION` enum value to the request property `spec/admission` - added the new `ADMISSION_LEVEL_ORGANIZATION` enum value to the request property `spec/ports/items/admission` - added the optional property `environment/spec/kernelControlsConfig` to the response with the `200` status - added the optional property `environment/spec/secrets/items/scope` to the response with the `200` status - **2026-01-21** `2423c089f280` — 2 breaking, 4 info - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` from the `spec/automationsFile/triggerFilter/items/` request property `oneOf` list - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` to the `environment/spec/automationsFile/triggerFilter/items/` response property `oneOf` list for the response status `200` - added the new optional request property `spec/automationsFile/triggerFilter/items/beforeSnapshot` - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` to the `spec/automationsFile/triggerFilter/items/` request property `oneOf` list - added the optional property `environment/spec/automationsFile/triggerFilter/items/beforeSnapshot` to the response with the `200` status - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` from the `environment/spec/automationsFile/triggerFilter/items/` response property `oneOf` list for the response status `200` - **2025-12-15** `d62ef4b9187c` — 3 breaking, 6 warning, 18 info - the `spec/ports/items/port` request property's min was increased to `1024.00` - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `spec/secrets/items/` request property `oneOf` list - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `environment/spec/secrets/items/` response property `oneOf` list for the response status `200` - added the new `CLONE_TARGET_MODE_REMOTE_TAG` enum value to the `environment/spec/content/initializer/specs/items/git/targetMode` response property for the response status `200` - added the new `CONTENT_PHASE_UNAVAILABLE` enum value to the `environment/status/automationsFile/phase` response property for the response status `200` - added the new `CONTENT_PHASE_UNAVAILABLE` enum value to the `environment/status/content/phase` response property for the response status `200` - added the new `CONTENT_PHASE_UNAVAILABLE` enum value to the `environment/status/secrets/items/phase` response property for the response status `200` - added the new `CONTENT_PHASE_UNAVAILABLE` enum value to the `environment/status/sshPublicKeys/items/phase` response property for the response status `200` - added the new `PRINCIPAL_AGENT_EXECUTION` enum value to the `environment/metadata/creator/principal` response property for the response status `200` - added the new optional request property `spec/automationsFile/triggerFilter` - added the new optional request property `spec/devcontainer/lifecycleStage` - added the new optional request property `spec/ports/items/protocol` - added the new optional request property `spec/secrets/items/apiOnly` - added the new optional request property `spec/workflowActionId` - added the new `CLONE_TARGET_MODE_REMOTE_TAG` enum value to the request property `spec/content/initializer/specs/items/git/targetMode` - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `spec/secrets/items/` request property `oneOf` list - added the optional property `environment/metadata/prebuildId` to the response with the `200` status - added the optional property `environment/metadata/role` to the response with the `200` status - added the optional property `environment/spec/automationsFile/triggerFilter` to the response with the `200` status - added the optional property `environment/spec/devcontainer/lifecycleStage` to the response with the `200` status - added the optional property `environment/spec/ports/items/protocol` to the response with the `200` status - added the optional property `environment/spec/secrets/items/apiOnly` to the response with the `200` status - added the optional property `environment/spec/workflowActionId` to the response with the `200` status - added the optional property `environment/status/environmentUrls/ops` to the response with the `200` status - added the optional property `environment/status/environmentUrls/supportBundle` to the response with the `200` status - added the optional property `environment/status/machine/versions/amiId` to the response with the `200` status - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `environment/spec/secrets/items/` response property `oneOf` list for the response status `200` - **2025-06-10** `ca9a49ac7fbb` — 1 warning, 7 info - added the new `PRINCIPAL_RUNNER_MANAGER` enum value to the `environment/metadata/creator/principal` response property for the response status `200` - added the new optional request property `spec/devcontainer/defaultDevcontainerImage` - added the new optional request property `spec/secrets/items/id` - added the optional property `environment/metadata/archivedAt` to the response with the `200` status - added the optional property `environment/spec/devcontainer/defaultDevcontainerImage` to the response with the `200` status - added the optional property `environment/spec/secrets/items/id` to the response with the `200` status - added the optional property `environment/status/automationsFile/warningMessage` to the response with the `200` status - added the optional property `environment/status/secrets/items/id` to the response with the `200` status - **2025-02-21** `3655d5ad0ac3` — 2 breaking, 1 warning, 16 info - the `spec` request property type/format changed from ``/`` to `object`/`` - the `environment` response's property type/format changed from ``/`` to `object`/`` for status `200` - removed `#/components/schemas/gitpod.v1.EnvironmentSpec` from the `spec` request property `allOf` list - added the new optional request property `spec/admission` - added the new optional request property `spec/automationsFile` - added the new optional request property `spec/content` - added the new optional request property `spec/desiredPhase` - added the new optional request property `spec/devcontainer` - added the new optional request property `spec/machine` - added the new optional request property `spec/ports` - added the new optional request property `spec/secrets` - added the new optional request property `spec/specVersion` - added the new optional request property `spec/sshPublicKeys` - added the new optional request property `spec/timeout` - added the optional property `environment/metadata` to the response with the `200` status - added the optional property `environment/spec` to the response with the `200` status - added the optional property `environment/status` to the response with the `200` status - removed `#/components/schemas/gitpod.v1.Environment` from the `environment` response property `allOf` list for the response status `200` - added the required property `environment/id` to the response with the `200` status - **2025-02-18** `cd6a05ae99d2` — 1 warning - removed the optional property `detail` from the response with the `default` status - **2025-02-18** `bef0e79f204c` — 3 info - added the new optional request property `spec/allOf[subschema #1: EnvironmentSpec]/devcontainer/allOf[subschema #1: DevContainer]/dotfiles` - added the optional property `environment/allOf[subschema #1: Environment]/spec/allOf[subschema #1: EnvironmentSpec]/devcontainer/allOf[subschema #1: DevContainer]/dotfiles` to the response with the `200` status - the response property `environment` became required for the status `200` - **2025-02-18** `f6598ab5d682` — 1 info - the response property `environment/allOf[subschema #1: Environment]/id` became required for the status `200` - **2025-02-14** `27f7bd641de1` — 1 breaking, 1 info - the `environment/allOf[subschema #1: Environment]/spec/allOf[subschema #1: EnvironmentSpec]/machine/allOf[subschema #1: Machine]/class` response's property type/format changed from `string`/`uuid` to `string`/`` for status `200` - the `spec/allOf[subschema #1: EnvironmentSpec]/machine/allOf[subschema #1: Machine]/class` request property type/format was generalized from `string`/`uuid` to `string`/`` --- [Operation](https://skmtc.dev/gitpod-io/apis/gitpod-v1/docs/gitpod.v1.EnvironmentService/CreateEnvironmentFromProject/post.md) · [API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [Page](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.EnvironmentService/CreateEnvironmentFromProject/post)