---
title: "Changes to Create a portal navigation item"
method: POST
path: "/portal-navigation-items"
---

# Changes to Create a portal navigation item

`POST /portal-navigation-items`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 17 of 65 revisions.

- **2026-08-10** `37e8cbe5f769`: 2 info
- **2026-08-05** `d179daa13dee`: 2 info
- **2026-07-31** `218efa41606c`: 1 breaking, 3 info
- **2026-07-16** `5d2bc7766648`: 1 breaking, 4 warning, 18 info
- **2026-05-22** `338b1b2ce119`: 1 info
- **2026-03-11** `472c019e0542`: 4 info
- **2026-03-09** `428714c3fc69`: 4 info
- **2026-02-27** `60f12237285b`: 1 info
- **2026-02-05** `97a6956cf335`: 1 breaking, 3 warning, 12 info
- **2026-01-08** `5174b3549872`: 6 info
- **2025-12-16** `a0c63b1f7282`: 3 breaking
- **2025-12-08** `3d821a60aafa`: 3 info
- **2025-12-01** `166b989192ac`: 3 info
- **2025-11-20** `cf51ea1eab84`: 1 breaking, 1 info
- **2025-11-20** `cd6dc7c66b90`: 1 breaking, 1 warning, 2 info
- **2025-11-20** `b1cf6083dac6`: 2 breaking, 2 info
- **2025-11-19** `0cc5095a6dc7`: 1 info

## Changes

- **2026-08-10** `37e8cbe5f769`: 2 info
  - added the optional property `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[subschema #2]/source/lastFetchAttemptAt` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/source/lastFetchAttemptAt` to the response with the `201` status
- **2026-08-05** `d179daa13dee`: 2 info
  - added the new optional request property `oneOf[subschema #4: CreatePortalNavigationApi]/allOf[subschema #2]/categoryIds`
  - added the optional property `oneOf[#/components/schemas/PortalNavigationApi]/allOf[subschema #2]/categoryIds` to the response with the `201` status
- **2026-07-31** `218efa41606c`: 1 breaking, 3 info
  - added `subschema #2` to the `oneOf[subschema #2: CreatePortalNavigationFolder]/` request property `allOf` list
  - added the new optional request property `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[subschema #2]/source`
  - added the optional property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/source` to the response with the `201` status
  - added `subschema #2` to the `oneOf[#/components/schemas/PortalNavigationFolder]/` response property `allOf` list for the response status `201`
- **2026-07-16** `5d2bc7766648`: 1 breaking, 4 warning, 18 info
  - added `#/components/schemas/PortalNavigationApiProduct` to the response body `oneOf` list for the response status `201`
  - added the new `API_PRODUCT` enum value to the `oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `201`
  - added the new `API_PRODUCT` enum value to the `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `201`
  - added the new `API_PRODUCT` enum value to the `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `201`
  - added the new `API_PRODUCT` enum value to the `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `201`
  - added `API_PRODUCT` mapping keys to the request discriminator
  - added `#/components/schemas/CreatePortalNavigationApiProduct` to the request body `oneOf` list
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/` request property
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[subschema #2: CreatePortalNavigationFolder]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/` request property
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[subschema #3: CreatePortalNavigationLink]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/` request property
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[subschema #4: CreatePortalNavigationApi]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/` request property
  - added the new `API_PRODUCT` enum value to the request property `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/type`
  - added the new `API_PRODUCT` enum value to the request property `oneOf[subschema #2: CreatePortalNavigationFolder]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/type`
  - added the new `API_PRODUCT` enum value to the request property `oneOf[subschema #3: CreatePortalNavigationLink]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/type`
  - added the new `API_PRODUCT` enum value to the request property `oneOf[subschema #4: CreatePortalNavigationApi]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/type`
  - added `API_PRODUCT` mapping keys to the response discriminator for the response status `201`
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `201`
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `201`
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `201`
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `201`
- **2026-05-22** `338b1b2ce119`: 1 info
  - added the new `ASYNCAPI` enum value to the request property `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[subschema #2]/contentType`
- **2026-03-11** `472c019e0542`: 4 info
  - the response property `oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `201`
  - the response property `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `201`
  - the response property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `201`
  - the response property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `201`
- **2026-03-09** `428714c3fc69`: 4 info
  - added the optional property `oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `201` status
- **2026-02-27** `60f12237285b`: 1 info
  - added the new optional request property `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[subschema #2]/contentType`
- **2026-02-05** `97a6956cf335`: 1 breaking, 3 warning, 12 info
  - added `#/components/schemas/PortalNavigationApi` to the response body `oneOf` list for the response status `201`
  - added the new `API` enum value to the `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `201`
  - added the new `API` enum value to the `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `201`
  - added the new `API` enum value to the `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `201`
  - added `API` mapping keys to the request discriminator
  - added `#/components/schemas/CreatePortalNavigationApi` to the request body `oneOf` list
  - added `API` discriminator mapping keys to the `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/` request property
  - added `API` discriminator mapping keys to the `oneOf[subschema #2: CreatePortalNavigationFolder]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/` request property
  - added `API` discriminator mapping keys to the `oneOf[subschema #3: CreatePortalNavigationLink]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/` request property
  - added the new `API` enum value to the request property `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/type`
  - added the new `API` enum value to the request property `oneOf[subschema #2: CreatePortalNavigationFolder]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/type`
  - added the new `API` enum value to the request property `oneOf[subschema #3: CreatePortalNavigationLink]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/type`
  - added `API` mapping keys to the response discriminator for the response status `201`
  - added `API` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `201`
  - added `API` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `201`
  - added `API` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `201`
- **2026-01-08** `5174b3549872`: 6 info
  - the `area` request property default value `TOP_NAVBAR` was added
  - the `area` request property default value `TOP_NAVBAR` was added
  - the `area` request property default value `TOP_NAVBAR` was added
  - the `area` response's property default value `TOP_NAVBAR` was added for the status `201`
  - the `area` response's property default value `TOP_NAVBAR` was added for the status `201`
  - the `area` response's property default value `TOP_NAVBAR` was added for the status `201`
- **2025-12-16** `a0c63b1f7282`: 3 breaking
  - added the new required request property `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/visibility`
  - added the new required request property `oneOf[subschema #2: CreatePortalNavigationFolder]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/visibility`
  - added the new required request property `oneOf[subschema #3: CreatePortalNavigationLink]/allOf[#/components/schemas/BaseCreatePortalNavigationItem]/visibility`
- **2025-12-08** `3d821a60aafa`: 3 info
  - added the required property `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/visibility` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/visibility` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/visibility` to the response with the `201` status
- **2025-12-01** `166b989192ac`: 3 info
  - added the required property `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `201` status
- **2025-11-20** `cf51ea1eab84`: 1 breaking, 1 info
  - the `oneOf[#/components/schemas/PortalNavigationLink]/allOf[subschema #2]/url` response's property format changed from `uri` to no format for status `201`
  - the `oneOf[subschema #3: CreatePortalNavigationLink]/allOf[subschema #2]/url` request property format was generalized from `uri` to no format
- **2025-11-20** `cd6dc7c66b90`: 1 breaking, 1 warning, 2 info
  - removed the required property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/contentId` from the response with the `201` status
  - removed the request property `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[subschema #2]/contentId`
  - added the new optional request property `oneOf[subschema #1: CreatePortalNavigationPage]/allOf[subschema #2]/portalPageContentId`
  - added the required property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/portalPageContentId` to the response with the `201` status
- **2025-11-20** `b1cf6083dac6`: 2 breaking, 2 info
  - removed the required property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[subschema #2]/configuration` from the response with the `201` status
  - removed the required property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/configuration` from the response with the `201` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[subschema #2]/url` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/contentId` to the response with the `201` status
- **2025-11-19** `0cc5095a6dc7`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/docs/portal-navigation-items/post.md) - [API](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) - [Page](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/changes/portal-navigation-items/post)