---
title: "Changes to Update a portal navigation item"
method: PUT
path: "/portal-navigation-items/{navId}"
---

# Changes to Update a portal navigation item

`PUT /portal-navigation-items/{navId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 65 revisions.

- **2026-08-10** `37e8cbe5f769`: 2 info
- **2026-08-06** `a2bffc8c2e17`: 1 breaking
- **2026-08-05** `d179daa13dee`: 2 info
- **2026-07-31** `218efa41606c`: 2 breaking, 2 info
- **2026-07-16** `5d2bc7766648`: 1 breaking, 4 warning, 16 info
- **2026-06-15** `3e55528dff6b`: 1 info
- **2026-03-11** `472c019e0542`: 4 info
- **2026-03-09** `428714c3fc69`: 4 info
- **2026-02-05** `97a6956cf335`: 1 breaking, 3 warning, 11 info
- **2026-01-08** `5174b3549872`: 3 info
- **2025-12-08** `bca583fe4e8a`: 3 breaking
- **2025-12-08** `3d821a60aafa`: 3 info
- **2025-12-02** `de1059feb4b7`: 3 breaking
- **2025-12-01** `166b989192ac`: 3 info
- **2025-11-27** `400c7d9e9390`: 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 `200` status
  - added the optional property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/source/lastFetchAttemptAt` to the response with the `200` status
- **2026-08-06** `a2bffc8c2e17`: 1 breaking
  - for the `path` request parameter `navId`, the format changed from no format to `uuid`
- **2026-08-05** `d179daa13dee`: 2 info
  - added the new optional request property `oneOf[subschema #4: UpdatePortalNavigationApi]/allOf[subschema #2]/categoryIds`
  - added the optional property `oneOf[#/components/schemas/PortalNavigationApi]/allOf[subschema #2]/categoryIds` to the response with the `200` status
- **2026-07-31** `218efa41606c`: 2 breaking, 2 info
  - added `subschema #2` to the `oneOf[subschema #1: UpdatePortalNavigationPage]/` request property `allOf` list
  - added `subschema #2` to the `oneOf[subschema #2: UpdatePortalNavigationFolder]/` request property `allOf` list
  - added the optional property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[subschema #2]/source` to the response with the `200` status
  - added `subschema #2` to the `oneOf[#/components/schemas/PortalNavigationFolder]/` response property `allOf` list for the response status `200`
- **2026-07-16** `5d2bc7766648`: 1 breaking, 4 warning, 16 info
  - added `#/components/schemas/PortalNavigationApiProduct` to the response body `oneOf` list for the response status `200`
  - added the new `API_PRODUCT` enum value to the `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 `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 `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 `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added `API_PRODUCT` mapping keys to the request discriminator
  - added `#/components/schemas/UpdatePortalNavigationApi, #/components/schemas/UpdatePortalNavigationApiProduct` to the request body `oneOf` list
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[subschema #1: UpdatePortalNavigationPage]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/` request property
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[subschema #2: UpdatePortalNavigationFolder]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/` request property
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[subschema #3: UpdatePortalNavigationLink]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/` request property
  - added the new `API_PRODUCT` enum value to the request property `oneOf[subschema #1: UpdatePortalNavigationPage]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/type`
  - added the new `API_PRODUCT` enum value to the request property `oneOf[subschema #2: UpdatePortalNavigationFolder]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/type`
  - added the new `API_PRODUCT` enum value to the request property `oneOf[subschema #3: UpdatePortalNavigationLink]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/type`
  - added `API_PRODUCT` mapping keys to the response discriminator for the response status `200`
  - 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 `200`
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API_PRODUCT` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
- **2026-06-15** `3e55528dff6b`: 1 info
  - added the new optional `query` request parameter `propagatePublishToChildren`
- **2026-03-11** `472c019e0542`: 4 info
  - the response property `oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` became required for the status `200`
  - the response property `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 `oneOf[#/components/schemas/PortalNavigationApi]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/rootId` to the response with the `200` status
- **2026-02-05** `97a6956cf335`: 1 breaking, 3 warning, 11 info
  - added `#/components/schemas/PortalNavigationApi` to the response body `oneOf` list for the response status `200`
  - added the new `API` enum value to the `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added the new `API` enum value to the `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added the new `API` enum value to the `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/type` response property for the response status `200`
  - added `API` mapping keys to the request discriminator
  - added `API` discriminator mapping keys to the `oneOf[subschema #1: UpdatePortalNavigationPage]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/` request property
  - added `API` discriminator mapping keys to the `oneOf[subschema #2: UpdatePortalNavigationFolder]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/` request property
  - added `API` discriminator mapping keys to the `oneOf[subschema #3: UpdatePortalNavigationLink]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/` request property
  - added the new `API` enum value to the request property `oneOf[subschema #1: UpdatePortalNavigationPage]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/type`
  - added the new `API` enum value to the request property `oneOf[subschema #2: UpdatePortalNavigationFolder]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/type`
  - added the new `API` enum value to the request property `oneOf[subschema #3: UpdatePortalNavigationLink]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/type`
  - added `API` mapping keys to the response discriminator for the response status `200`
  - added `API` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
  - added `API` discriminator mapping keys to the `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/` response property for the response status `200`
- **2026-01-08** `5174b3549872`: 3 info
  - 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** `bca583fe4e8a`: 3 breaking
  - added the new required request property `oneOf[subschema #1: UpdatePortalNavigationPage]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/visibility`
  - added the new required request property `oneOf[subschema #2: UpdatePortalNavigationFolder]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/visibility`
  - added the new required request property `oneOf[subschema #3: UpdatePortalNavigationLink]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/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 `200` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/visibility` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/visibility` to the response with the `200` status
- **2025-12-02** `de1059feb4b7`: 3 breaking
  - added the new required request property `oneOf[subschema #1: UpdatePortalNavigationPage]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/published`
  - added the new required request property `oneOf[subschema #2: UpdatePortalNavigationFolder]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/published`
  - added the new required request property `oneOf[subschema #3: UpdatePortalNavigationLink]/allOf[#/components/schemas/BaseUpdatePortalNavigationItem]/published`
- **2025-12-01** `166b989192ac`: 3 info
  - added the required property `oneOf[#/components/schemas/PortalNavigationFolder]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationLink]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/PortalNavigationPage]/allOf[#/components/schemas/BasePortalNavigationItem]/published` to the response with the `200` status
- **2025-11-27** `400c7d9e9390`: 1 info
  - endpoint added

---

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