---
title: "Delete a portal navigation item"
method: DELETE
path: "/portal-navigation-items/{navId}"
tags: ["Portal Navigation Items"]
---

# Delete a portal navigation item

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

## Request

- Base URL: `/management/v2/environments/DEFAULT` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/management/v2/environments/DEFAULT/portal-navigation-items/{navId}`
- Auth: one of:
  - HTTP basic
  - API key in cookie `Auth-Graviteeio-APIM`

User must have the ENVIRONMENT_DOCUMENTATION[delete] permission.

## Path parameters

- `navId` string, uuid, required

## Response `204`

Portal navigation item deleted

## Other responses

- `default`: Generic error response

## Changes

- **2026-08-06** `a2bffc8c2e17`: 1 breaking
  - for the `path` request parameter `navId`, the format changed from no format to `uuid`
- **2026-06-15** `e863818a6e43`: 1 warning
  - deleted the `query` request parameter `propagateDeleteToChildren`
- **2026-06-15** `3e55528dff6b`: 1 info
  - added the new optional `query` request parameter `propagateDeleteToChildren`
- **2025-12-15** `9c1bbe80af6a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/changes/portal-navigation-items/:navId/delete.md)

---

[API](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) - [All operations](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) - [OpenAPI document](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/revisions/b736a7e375df?raw)