---
title: "Changes to Adds a new Environment to an existing Portfolio"
method: POST
path: "/portfolios/{portfolioId}/environments"
---

# Changes to Adds a new Environment to an existing Portfolio

`POST /portfolios/{portfolioId}/environments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 52 revisions.

- **2026-07-13** `22014acb308f`: 1 breaking, 1 warning
- **2025-06-17** `89a739bd933b`: 1 warning, 1 info
- **2025-06-16** `3bf5eb815001`: 1 warning
- **2024-06-03** `682acb0b28b6`: 1 info
- **2023-10-19** `a61a8cf84512`: 1 warning, 1 info
- **2023-10-10** `0fe40bce74d0`: 1 warning, 1 info
- **2023-10-10** `82e60c01355b`: 2 warning, 2 info
- **2023-10-05** `955d3f2e1d84`: 6 info
- **2023-02-10** `c20f3ebace53`: 2 warning, 2 info
- **2023-02-10** `0290bea4247c`: 2 warning, 1 info
- **2023-02-10** `125039a132bc`: 3 breaking, 3 warning, 6 info
- **2023-01-31** `9fbf5defc05a`: 1 info

## Changes

- **2026-07-13** `22014acb308f`: 1 breaking, 1 warning
  - added the new required request property `administrators`
  - removed the request property `operators`
- **2025-06-17** `89a739bd933b`: 1 warning, 1 info
  - removed `#/components/schemas/EnvironmentPatch` from the request body `allOf` list
  - added the new optional request property `operators`
- **2025-06-16** `3bf5eb815001`: 1 warning
  - removed the request property `allOf[#/components/schemas/EnvironmentPatch]/administrators`
- **2024-06-03** `682acb0b28b6`: 1 info
  - added the non-success response with the status `405`
- **2023-10-19** `a61a8cf84512`: 1 warning, 1 info
  - changed the pattern of the request property `allOf[#/components/schemas/EnvironmentResponse]/account_name` from `^[A-Za-z0-9](?:[A-Za-z0-9\-_]{0,61}[A-Za-z0-9])$` to `^[a-zA-Z][a-zA-Z0-9]{5,25}$`
  - the `account_name` response's property pattern was changed from `^[A-Za-z0-9](?:[A-Za-z0-9\-_]{0,61}[A-Za-z0-9])$` to `^[a-zA-Z][a-zA-Z0-9]{5,25}$` for the status `200`
- **2023-10-10** `0fe40bce74d0`: 1 warning, 1 info
  - changed the pattern of the request property `allOf[#/components/schemas/EnvironmentResponse]/account_name` from `^[A-Za-z0-9](?:[A-Za-z0-9\-_]{0,61}[A-Za-z0-9])?$` to `^[A-Za-z0-9](?:[A-Za-z0-9\-_]{0,61}[A-Za-z0-9])$`
  - the `account_name` response's property pattern was changed from `^[A-Za-z0-9](?:[A-Za-z0-9\-_]{0,61}[A-Za-z0-9])?$` to `^[A-Za-z0-9](?:[A-Za-z0-9\-_]{0,61}[A-Za-z0-9])$` for the status `200`
- **2023-10-10** `82e60c01355b`: 2 warning, 2 info
  - removed the request property `allOf[#/components/schemas/EnvironmentResponse]/domain_name`
  - removed the optional property `domain_name` from the response with the `200` status
  - added the new optional request property `allOf[#/components/schemas/EnvironmentResponse]/account_name`
  - added the optional property `account_name` to the response with the `200` status
- **2023-10-05** `955d3f2e1d84`: 6 info
  - added the new optional request property `allOf[#/components/schemas/EnvironmentResponse]/domain_name`
  - added the new optional request property `allOf[#/components/schemas/EnvironmentResponse]/email_distribution_list`
  - added the new optional request property `allOf[#/components/schemas/EnvironmentResponse]/is_migration`
  - added the optional property `domain_name` to the response with the `200` status
  - added the optional property `email_distribution_list` to the response with the `200` status
  - added the optional property `is_migration` to the response with the `200` status
- **2023-02-10** `c20f3ebace53`: 2 warning, 2 info
  - added the new `FAILURE` enum value to the `status` response property for the response status `202`
  - added the new `SUCCESS` enum value to the `status` response property for the response status `202`
  - removed the `COMPLETE` enum value from the `status` response property for the response status `202`
  - removed the `FAILED` enum value from the `status` response property for the response status `202`
- **2023-02-10** `0290bea4247c`: 2 warning, 1 info
  - deleted the `header` request parameter `X-Atat-Api-Version`
  - deleted the `path` request parameter `portfolioId`
  - added the new optional `header` request parameter `X-Atat-Api-Version` to all path's operations
- **2023-02-10** `125039a132bc`: 3 breaking, 3 warning, 6 info
  - removed the enum value `secret` of the request property `allOf[#/components/schemas/EnvironmentResponse]/classification_level`
  - removed the enum value `top_secret` of the request property `allOf[#/components/schemas/EnvironmentResponse]/classification_level`
  - removed the enum value `unclassified` of the request property `allOf[#/components/schemas/EnvironmentResponse]/classification_level`
  - added the new `SECRET` enum value to the `classification_level` response property for the response status `200`
  - added the new `TOP_SECRET` enum value to the `classification_level` response property for the response status `200`
  - added the new `UNCLASSIFIED` enum value to the `classification_level` response property for the response status `200`
  - added the new `SECRET` enum value to the request property `allOf[#/components/schemas/EnvironmentResponse]/classification_level`
  - added the new `TOP_SECRET` enum value to the request property `allOf[#/components/schemas/EnvironmentResponse]/classification_level`
  - added the new `UNCLASSIFIED` enum value to the request property `allOf[#/components/schemas/EnvironmentResponse]/classification_level`
  - removed the `secret` enum value from the `classification_level` response property for the response status `200`
  - removed the `top_secret` enum value from the `classification_level` response property for the response status `200`
  - removed the `unclassified` enum value from the `classification_level` response property for the response status `200`
- **2023-01-31** `9fbf5defc05a`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/dod-ccpo/apis/atat-csp-api/docs/portfolios/:portfolioId/environments/post.md) - [API](https://skmtc.dev/dod-ccpo/apis/atat-csp-api.md) - [Page](https://skmtc.dev/dod-ccpo/apis/atat-csp-api/changes/portfolios/:portfolioId/environments/post)