---
title: "Changes to Adds a new Portfolio"
method: POST
path: "/portfolios"
---

# Changes to Adds a new Portfolio

`POST /portfolios`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 15 of 50 revisions.

- **2024-05-13** `682acb0b28b6` — 1 info
- **2023-10-05** `955d3f2e1d84` — 2 warning
- **2023-09-27** `6c8abf4c408c` — 2 info
- **2023-02-10** `0290bea4247c` — 1 warning, 1 info
- **2023-02-10** `125039a132bc` — 5 breaking, 5 warning, 10 info
- **2023-01-31** `9fbf5defc05a` — 3 breaking, 3 warning, 4 info
- **2022-12-29** `70da8a528a1a` — 2 info
- **2022-10-20** `0012adbb99c0` — 1 breaking
- **2022-10-14** `1574d89ae20e` — 1 info
- **2022-10-14** `9567c2027179` — 1 warning
- **2022-10-13** `513c267a952d` — 1 info
- **2022-09-23** `1f0c7e0961f2` — 6 breaking, 14 info
- **2022-05-11** `3e2c894fb464` — 2 info
- **2022-05-11** `519042d1a807` — 1 warning, 2 info
- **2022-04-28** `0aaa4c57a985` — 7 breaking, 3 warning, 12 info

## Changes

- **2024-05-13** `682acb0b28b6` — 1 info
  - added the non-success response with the status `405`
- **2023-10-05** `955d3f2e1d84` — 2 warning
  - removed the request property `migrationOfPortfolioRequired`
  - removed the optional property `migrationOfPortfolioRequired` from the response with the `200` status
- **2023-09-27** `6c8abf4c408c` — 2 info
  - added the new optional request property `migrationOfPortfolioRequired`
  - added the optional property `migrationOfPortfolioRequired` to the response with the `200` status
- **2023-02-10** `0290bea4247c` — 1 warning, 1 info
  - deleted the `header` request parameter `X-Atat-Api-Version`
  - added the new optional `header` request parameter `X-Atat-Api-Version` to all path's operations
- **2023-02-10** `125039a132bc` — 5 breaking, 5 warning, 10 info
  - removed the enum value `cloud` of the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type`
  - removed the enum value `non_cloud` of the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type`
  - removed the enum value `secret` of the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level`
  - removed the enum value `top_secret` of the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level`
  - removed the enum value `unclassified` of the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level`
  - added the new `CLOUD` enum value to the `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 `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 `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 `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 `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` response property for the response status `200`
  - added the new `CLOUD` enum value to the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type`
  - added the new `NON_CLOUD` enum value to the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type`
  - added the new `SECRET` enum value to the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level`
  - added the new `TOP_SECRET` enum value to the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level`
  - added the new `UNCLASSIFIED` enum value to the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level`
  - removed the `cloud` enum value from the `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 `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type` response property for the response status `200`
  - removed the `secret` enum value from the `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 `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 `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` response property for the response status `200`
- **2023-01-31** `9fbf5defc05a` — 3 breaking, 3 warning, 4 info
  - added the new required request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type`
  - removed the required property `dashboard_link` from the response with the `200` status
  - removed the success response with the status `202`
  - removed `#/components/schemas/PortfolioPatch` from the request body `allOf` list
  - deleted the `header` request parameter `X-Provision-Deadline`
  - deleted the `header` request parameter `X-Target-Impact-Level`
  - added the new optional request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level`
  - removed `#/components/schemas/PortfolioPatch` from the response body `allOf` list for the response status `200`
  - added the optional property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` to the response with the `200` status
  - added the required property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type` to the response with the `200` status
- **2022-12-29** `70da8a528a1a` — 2 info
  - the request required property `dashboard_link` became read-only
  - the response required property `dashboard_link` became read-only for the status `200`
- **2022-10-20** `0012adbb99c0` — 1 breaking
  - the response property `portfolio_id` became optional for the status `202`
- **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` — 6 breaking, 14 info
  - the request property `allOf[#/components/schemas/PortfolioPatch]/administrators/items/dod_id` became required
  - the request property `allOf[#/components/schemas/PortfolioPatch]/administrators/items/email` became required
  - the request property `dashboard_link` became required
  - the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/clin_number` became required
  - the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/pop_end_date` became required
  - the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/pop_start_date` became required
  - added the new enum value `TS` to the `header` request parameter `X-Target-Impact-Level`
  - the request property `allOf[#/components/schemas/PortfolioPatch]/administrators/items/needs_reset` with a default value became required
  - 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 `portfolio_id` became required for the status `202`
  - the response property `provisioning_job_id` became required for the status `202`
  - the response property `status` became required for the status `202`
  - 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/write-portfolio` was added to the endpoint's security scheme `oidc`
  - the security scope `write:portfolio` was removed from the endpoint's security scheme `oidc`
- **2022-05-11** `519042d1a807` — 1 warning, 2 info
  - removed the optional property `id` from the response with the `202` status
  - added the optional property `portfolio_id` to the response with the `202` status
  - added the optional property `provisioning_job_id` to the response with the `202` status
- **2022-04-28** `0aaa4c57a985` — 7 breaking, 3 warning, 12 info
  - added `#/components/schemas/PortfolioPatch` to the request body `allOf` list
  - the response property `id` became optional for the status `200`
  - the response property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/clin_number` became optional for the status `200`
  - the response property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/pop_end_date` became optional for the status `200`
  - the response property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/pop_start_date` became optional for the status `200`
  - removed the required property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type` from the response with the `200` status
  - removed the required property `task_orders/items/allOf[#/components/schemas/TaskOrder]/id` from the response with the `200` status
  - removed the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level`
  - removed the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/type`
  - removed the optional property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/classification_level` from the response with the `200` status
  - the security scope `write:portfolio` was added to the endpoint's security scheme `oidc`
  - the security scope `atat/write-portfolio` was removed from the endpoint's security scheme `oidc`
  - added the new optional `header` request parameter `X-Provision-Deadline`
  - added the new optional `header` request parameter `X-Target-Impact-Level`
  - added the new optional request property `dashboard_link`
  - the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/clin_number` became optional
  - the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/pop_end_date` became optional
  - the request property `task_orders/items/allOf[#/components/schemas/TaskOrder]/clins/items/pop_start_date` became optional
  - added `#/components/schemas/PortfolioPatch` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `405`
  - added the optional property `dashboard_link` to the response with the `200` status
  - added the success response with the status `202`

---

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