37e8cbe5f769

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-106593121.1 KB
Portal Navigation Items

Fetch the content of a portal navigation item from its external source

User must have the ENVIRONMENT_DOCUMENTATION[update] permission. On a PAGE carrying an external source, fetches the page content and returns the updated item. On a container item such as a FOLDER, fetches every PAGE descendant carrying an external source and returns a success/failure summary. A source carried by the FOLDER itself is not fetched yet: only the sources of the PAGE items below it are.

post/portal-navigation-items/{navId}/_fetch

Path parameters

navIdstring uuid required

The unique ID of the navigation item

Response

Fetch result. item is set when the target is a sourced PAGE, summary when the fetch walked a subtree.

Example response

{
  "item": {
    "id": "00f8c9e7-78fc-4907-b8c9-e778fc790750",
    "organizationId": "DEFAULT",
    "environmentId": "DEFAULT",
    "type": "FOLDER",
    "area": "TOP_NAVBAR",
    "parentId": "00f8c9e7-78fc-4907-b8c9-e778fc790750",
    "rootId": "00f8c9e7-78fc-4907-b8c9-e778fc790750",
    "order": 2,
    "published": true,
    "visibility": "PUBLIC",
    "portalPageContentId": "00f8c9e7-78fc-4907-b8c9-e778fc790750",
    "source": {
      "type": "github-fetcher",
      "fetchCron": "0 */10 * * * *",
      "lastFetchedAt": "2026-07-17T00:00:00.000Z",
      "lastFetchAttemptAt": "2026-07-17T00:00:00.000Z"
    }
  },
  "summary": {
    "results": [
      {
        "navigationItemId": "00f8c9e7-78fc-4907-b8c9-e778fc790750"
      }
    ]
  }
}