---
title: "Changes to Get portal navigation items"
method: GET
path: "/portal-navigation-items"
---

# Changes to Get portal navigation items

`GET /portal-navigation-items`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 65 revisions.

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

## Changes

- **2026-08-12** `1b43518fec30`: 2 info
  - added the new optional `query` request parameter `includes`
  - added the optional property `metadata` to the response with the `200` status
- **2026-08-10** `37e8cbe5f769`: 2 info
  - added the optional property `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[subschema #2]/source/lastFetchAttemptAt` to the response with the `200` status
  - added the optional property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/source/lastFetchAttemptAt` to the response with the `200` status
- **2026-08-05** `d179daa13dee`: 1 info
  - added the optional property `items/items/oneOf[#/components/schemas/PortalNavigationApi]/allOf[subschema #2]/categoryIds` to the response with the `200` status
- **2026-07-31** `218efa41606c`: 2 info
  - added the optional property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/source` to the response with the `200` status
  - added `subschema #2` to the `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/` response property `allOf` list for the response status `200`
- **2026-07-16** `5d2bc7766648`: 1 breaking, 4 warning, 5 info
  - added `#/components/schemas/PortalNavigationApiProduct` to the `items/items/` response property `oneOf` list for the response status `200`
  - added the new `API_PRODUCT` enum value to the `items/items/oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added the new `API_PRODUCT` enum value to the `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added the new `API_PRODUCT` enum value to the `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added the new `API_PRODUCT` enum value to the `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added `API_PRODUCT` discriminator mapping keys to the `items/items/` response property for the response status `200`
  - added `API_PRODUCT` discriminator mapping keys to the `items/items/oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API_PRODUCT` discriminator mapping keys to the `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API_PRODUCT` discriminator mapping keys to the `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API_PRODUCT` discriminator mapping keys to the `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
- **2026-03-11** `472c019e0542`: 4 info
  - the response property `items/items/oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `200`
  - the response property `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `200`
  - the response property `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `200`
  - the response property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `200`
- **2026-03-09** `428714c3fc69`: 4 info
  - added the optional property `items/items/oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `200` status
  - added the optional property `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `200` status
  - added the optional property `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `200` status
  - added the optional property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `200` status
- **2026-02-05** `97a6956cf335`: 1 breaking, 3 warning, 4 info
  - added `#/components/schemas/PortalNavigationApi` to the `items/items/` response property `oneOf` list for the response status `200`
  - added the new `API` enum value to the `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added the new `API` enum value to the `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added the new `API` enum value to the `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added `API` discriminator mapping keys to the `items/items/` response property for the response status `200`
  - added `API` discriminator mapping keys to the `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API` discriminator mapping keys to the `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API` discriminator mapping keys to the `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
- **2026-01-08** `5174b3549872`: 4 info
  - the `query` request parameter `area` became optional
  - the `area` response's property default value `TOP_NAVBAR` was added for the status `200`
  - the `area` response's property default value `TOP_NAVBAR` was added for the status `200`
  - the `area` response's property default value `TOP_NAVBAR` was added for the status `200`
- **2025-12-08** `3d821a60aafa`: 3 info
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/visibility` to the response with the `200` status
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/visibility` to the response with the `200` status
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/visibility` to the response with the `200` status
- **2025-12-01** `166b989192ac`: 3 info
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `200` status
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `200` status
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `200` status
- **2025-11-20** `cf51ea1eab84`: 1 breaking
  - the `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[subschema #2]/url` response's property format changed from `uri` to no format for status `200`
- **2025-11-20** `cd6dc7c66b90`: 1 breaking, 1 info
  - removed the required property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/contentId` from the response with the `200` status
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/portalPageContentId` to the response with the `200` status
- **2025-11-20** `b1cf6083dac6`: 2 breaking, 2 info
  - removed the required property `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[subschema #2]/configuration` from the response with the `200` status
  - removed the required property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/configuration` from the response with the `200` status
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[subschema #2]/url` to the response with the `200` status
  - added the required property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/contentId` to the response with the `200` status
- **2025-11-19** `0cc5095a6dc7`: 2 info
  - the response property `items/items/oneOf[#/components/schemas/PortalNavigationLink]/allOf[subschema #2]/configuration` became required for the status `200`
  - the response property `items/items/oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/configuration` became required for the status `200`

---

[Operation](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/docs/portal-navigation-items/get.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/get)
