Upsert Menu | Gorilla Dash

curl -X PUT https://api.gorilladash.com/api/v1/website-content/websites/%7BWEBSITE_ID%7D/menus/upsert \
     -H "GorillaDash-Api-Key: {{API_KEY}}" \
     -H "GorillaDash-Api-Secret: {{GD_RESTFUL_SECRET}}" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Main Menu",
  "items": [
    {
      "label": "About",
      "url": "/about/",
      "children": [
        {
          "label": "Board",
          "url": "/about/board-of-directors"
        },
        {
          "label": "Old page",
          "url": "/not-imported/"
        }
      ]
    },
    {
      "label": "Join",
      "url": "https://join.example.org/",
      "children": [
        {
          "label": "string",
          "url": "string"
        }
      ]
    },
    {
      "label": "Resources",
      "url": "string",
      "children": [
        {
          "label": "string",
          "url": "string"
        }
      ]
    }
  ]
}'

{
  "success": true,
  "status": 201,
  "data": {
    "id": 341,
    "website_id": 206,
    "name": "Main Menu",
    "created_at": "2026-10-07T01:20:00+00:00",
    "updated_at": "2026-10-07T01:20:00+00:00",
    "items": [
      {
        "id": 9001,
        "label": "About",
        "type": "page",
        "page_id": 5520,
        "page_slug": "about",
        "children": [
          {
            "id": 9002,
            "label": "Board",
            "type": "page",
            "page_id": 5521,
            "page_slug": "about/board-of-directors",
            "children": []
          },
          {
            "id": 9003,
            "label": "Old page",
            "type": "internal_url",
            "page_id": 1,
            "page_slug": "string",
            "children": [],
            "url": null
          }
        ]
      },
      {
        "id": 9004,
        "label": "Join",
        "type": "external_url",
        "page_id": 1,
        "page_slug": "string",
        "children": [],
        "url": null
      },
      {
        "id": 9005,
        "label": "Resources",
        "type": "placeholder",
        "page_id": 1,
        "page_slug": "string",
        "children": []
      }
    ]
  }
}

Creates the menu, or updates the one with the same name. Needs a key with Website Content: Read and Write (website-content:write).

The body and rules are the same as Create Menu. Sending an identical payload again writes nothing: no duplicate, the id is kept and updated_at does not change, so a migration can be re-run safely.

Sending items replaces the whole tree, and the menu is only rebuilt when the tree differs from what is stored (the previous version stays in the menu editor’s history). A soft-deleted menu with the same name is restored.

Request

This endpoint expects an object.

namestringRequired

itemslist of objectsRequired

Response

Created

successboolean

statusinteger

dataobject

Headers

Request

Response