← Documentation home
PATCH/hyax-api/v1/navigation

Update navigation links

Batch create, update, delete, or reorder links. All operations run in one transaction. CATEGORY links require categoryId; PAGE links require a published pageId.

Base URL: https://platform.hyax.com · Replace YOUR_API_KEY with your team API key.

Request body

FieldRequiredDescription
linkPlacementNo`HEADER` (default) or `FOOTER`
createNoArray of { label, order, url?, navigationType?, parentId?, categoryId?, pageId? }
updateNoArray of { id, label?, url?, order?, … }
deleteIdsNoArray of link IDs to delete
reorderNoArray of { id, order, parentId? }

Request examples

Same request in cURL, Node.js (fetch), and PHP (ext-curl).

curl -X PATCH 'https://platform.hyax.com/hyax-api/v1/navigation' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "linkPlacement": "HEADER",
    "create": [
      {
        "label": "Pricing",
        "url": "/pricing",
        "order": 3
      }
    ],
    "reorder": [
      {
        "id": "clx…",
        "order": 0
      }
    ]
  }'

Example response

Shape varies by data; values are illustrative.

{
  "success": true,
  "summary": { "created": 1, "updated": 0, "deleted": 0, "reordered": 1 },
  "linkPlacement": "HEADER",
  "data": []
}