Update Sitemap
Updates an existing sitemap — the Edit Sitemap action on the admin Marketing → Search & SEO → Sitemaps screen.
New here? Read the Sitemaps overview for what a sitemap does and how its fields behave.
Channels are replaced, not merged
Sending channels sets the sitemap's channels to exactly that list, so include every channel it should cover. Leaving it out keeps the current ones, which is what makes renaming a file safe.
Updating does not regenerate the XML
Editing the definition does not rebuild the XML files. Call the generate mutation explicitly after an update.
Operation
| Operation | Type | Purpose |
|---|---|---|
updateAdminMarketingSitemap | Mutation | Update a sitemap definition |
Details
- Requires an admin Bearer token and the
marketing.search_seo.sitemaps.editpermission. - Pass the sitemap's IRI as
id. The update is a partial merge — send only the fields you want to change; omitted fields keep their existing values. - The mutation returns the full updated sitemap payload.
Input fields
| Field | Type | Required | Notes |
|---|---|---|---|
id | ID | Yes | The sitemap's IRI |
fileName | String | No | Index file name — letters, digits, -, _, .; must end with .xml |
path | String | No | Directory the index file lives in — must start and end with /, no // |
channels | [Int] | No | Channel ids the sitemap covers. The list you send replaces the current one; omit it to keep the channels the sitemap already covers |