---
title: "Changes to Gets an existing Portfolio"
method: GET
path: "/portfolios/{portfolioId}"
---

# Changes to Gets an existing Portfolio

`GET /portfolios/{portfolioId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 16 of 50 revisions.

- **2024-04-25** `e5ab2d7e0f04` — 9 info
- **2023-10-19** `a61a8cf84512` — 1 info
- **2023-10-10** `0fe40bce74d0` — 1 info
- **2023-10-10** `82e60c01355b` — 1 warning, 1 info
- **2023-10-05** `955d3f2e1d84` — 1 warning, 3 info
- **2023-09-27** `6c8abf4c408c` — 1 info
- **2023-02-10** `0290bea4247c` — 2 warning, 1 info
- **2023-02-10** `125039a132bc` — 8 warning, 8 info
- **2023-01-31** `9fbf5defc05a` — 4 breaking, 1 warning, 3 info
- **2022-12-29** `70da8a528a1a` — 1 info
- **2022-10-14** `1574d89ae20e` — 1 info
- **2022-10-14** `9567c2027179` — 1 warning
- **2022-10-13** `513c267a952d` — 1 info
- **2022-09-23** `1f0c7e0961f2` — 10 info
- **2022-05-11** `3e2c894fb464` — 2 info
- **2022-04-28** `0aaa4c57a985` — 3 breaking, 9 info

## Changes

- **2024-04-25** `e5ab2d7e0f04` — 9 info
  - added the optional property `environments/items/account_name` to the response with the `200` status
  - added the optional property `environments/items/cloud_distinguisher` to the response with the `200` status
  - added the optional property `environments/items/email_distribution_list` to the response with the `200` status
  - added the optional property `environments/items/is_migration` to the response with the `200` status
  - removed `#/components/schemas/Environment` from the `environments/items/` response property `allOf` list for the response status `200`
  - added the required property `environments/items/classification_level` to the response with the `200` status
  - added the required property `environments/items/dashboard_link` to the response with the `200` status
  - added the required property `environments/items/id` to the response with the `200` status
  - added the required property `environments/items/name` to the response with the `200` status
- **2023-10-19** `a61a8cf84512` — 1 info
  - the `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/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 info
  - the `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/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` — 1 warning, 1 info
  - removed the optional property `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/domain_name` from the response with the `200` status
  - added the optional property `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/account_name` to the response with the `200` status
- **2023-10-05** `955d3f2e1d84` — 1 warning, 3 info
  - removed the optional property `allOf[#/components/schemas/PortfolioCreate]/migrationOfPortfolioRequired` from the response with the `200` status
  - added the optional property `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/domain_name` to the response with the `200` status
  - added the optional property `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/email_distribution_list` to the response with the `200` status
  - added the optional property `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/is_migration` to the response with the `200` status
- **2023-09-27** `6c8abf4c408c` — 1 info
  - added the optional property `allOf[#/components/schemas/PortfolioCreate]/migrationOfPortfolioRequired` to the response with the `200` status
- **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` — 8 warning, 8 info
  - added the new `CLOUD` enum value to the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type` response property for the response status `200`
  - added the new `NON_CLOUD` enum value to the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type` response property for the response status `200`
  - added the new `SECRET` enum value to the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` response property for the response status `200`
  - added the new `SECRET` enum value to the `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/classification_level` response property for the response status `200`
  - added the new `TOP_SECRET` enum value to the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` response property for the response status `200`
  - added the new `TOP_SECRET` enum value to the `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/classification_level` response property for the response status `200`
  - added the new `UNCLASSIFIED` enum value to the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` response property for the response status `200`
  - added the new `UNCLASSIFIED` enum value to the `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/classification_level` response property for the response status `200`
  - removed the `cloud` enum value from the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type` response property for the response status `200`
  - removed the `non_cloud` enum value from the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type` response property for the response status `200`
  - removed the `secret` enum value from the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` response property for the response status `200`
  - removed the `secret` enum value from the `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/classification_level` response property for the response status `200`
  - removed the `top_secret` enum value from the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` response property for the response status `200`
  - removed the `top_secret` enum value from the `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/classification_level` response property for the response status `200`
  - removed the `unclassified` enum value from the `allOf[#/components/schemas/PortfolioCreate]/task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` response property for the response status `200`
  - removed the `unclassified` enum value from the `environments/items/allOf[#/components/schemas/Environment]/allOf[#/components/schemas/EnvironmentResponse]/classification_level` response property for the response status `200`
- **2023-01-31** `9fbf5defc05a` — 4 breaking, 1 warning, 3 info
  - removed the required property `dashboard_link` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `task_orders` from the response with the `200` status
  - deleted the `header` request parameter `X-Target-Impact-Level`
  - added `#/components/schemas/PortfolioCreate` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/PortfolioPatch` from the response body `allOf` list for the response status `200`
  - added the required property `environments` to the response with the `200` status
- **2022-12-29** `70da8a528a1a` — 1 info
  - the response required property `dashboard_link` became read-only for the status `200`
- **2022-10-14** `1574d89ae20e` — 1 info
  - added the new optional `header` request parameter `X-Atat-Api-Version`
- **2022-10-14** `9567c2027179` — 1 warning
  - deleted the `header` request parameter `X-Atat-Api-Version`
- **2022-10-13** `513c267a952d` — 1 info
  - added the new optional `header` request parameter `X-Atat-Api-Version`
- **2022-09-23** `1f0c7e0961f2` — 10 info
  - added the new enum value `TS` to the `header` request parameter `X-Target-Impact-Level`
  - the response property `allOf[#/components/schemas/PortfolioPatch]/administrators/items/dod_id` became required for the status `200`
  - the response property `allOf[#/components/schemas/PortfolioPatch]/administrators/items/email` became required for the status `200`
  - the response property `allOf[#/components/schemas/PortfolioPatch]/administrators/items/needs_reset` became required for the status `200`
  - the response property `dashboard_link` became required for the status `200`
  - the response property `id` became required for the status `200`
  - the response property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/clin_number` became required for the status `200`
  - the response property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/pop_end_date` became required for the status `200`
  - the response property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/pop_start_date` became required for the status `200`
  - added the required property `task_orders/items/allOf[#/components/schemas/TaskOrder]/id` to the response with the `200` status
- **2022-05-11** `3e2c894fb464` — 2 info
  - the security scope `atat/read-portfolio` was added to the endpoint's security scheme `oidc`
  - the security scope `read:portfolio` was removed from the endpoint's security scheme `oidc`
- **2022-04-28** `0aaa4c57a985` — 3 breaking, 9 info
  - added the new path request parameter `portfolioId`
  - the response property `id` became optional for the status `200`
  - removed the required property `environments` from the response with the `200` status
  - the security scope `read:portfolio` was added to the endpoint's security scheme `oidc`
  - the security scope `atat/read-portfolio` was removed from the endpoint's security scheme `oidc`
  - added the new optional `header` request parameter `X-Target-Impact-Level`
  - added `#/components/schemas/PortfolioPatch` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/PortfolioCreate` from the response body `allOf` list for the response status `200`
  - added the optional property `dashboard_link` to the response with the `200` status
  - added the optional property `id` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `task_orders` to the response with the `200` status

---

[Operation](https://skmtc.dev/dod-ccpo/apis/atat-csp-api/docs/portfolios/:portfolioId/get.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/get)