---
title: "PATCH /cms/url-redirects/2026-09/{urlRedirectId}"
method: PATCH
path: "/cms/url-redirects/2026-09/{urlRedirectId}"
tags: ["Basic"]
---

# PATCH /cms/url-redirects/2026-09/{urlRedirectId}

`PATCH /cms/url-redirects/2026-09/{urlRedirectId}`

## Path parameters

- `urlRedirectId` string, required

## Request body

- UrlMapping
  - `created` string, date-time, required — The date and time when the URL mapping was initially created.
  - `destination` string, required — The destination URL, where the target URL should be redirected if it matches the `routePrefix`.
  - `id` string, required — The unique ID of this URL redirect.
  - `isMatchFullUrl` boolean, required — Whether the `routePrefix` should match on the entire URL, including the domain.
  - `isMatchQueryString` boolean, required — Whether the `routePrefix` should match on the entire URL path, including the query string.
  - `isOnlyAfterNotFound` boolean, required — Whether the URL redirect mapping should apply only if a live page on the URL isn't found. If False, the URL redirect mapping will take precedence over any existing page.
  - `isPattern` boolean, required — Whether the `routePrefix` should match based on pattern.
  - `isProtocolAgnostic` boolean, required — Whether the `routePrefix` should match both HTTP and HTTPS protocols.
  - `isTrailingSlashOptional` boolean, required — Whether a trailing slash will be ignored.
  - `precedence` integer, required — Used to prioritize URL redirection. If a given URL matches more than one redirect, the one with the **lower** precedence will be used.
  - `redirectStyle` integer, required — The type of redirect to create. Options include: 301 (permanent), 302 (temporary), or 305 (proxy). Find more details [here](https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page).
  - `routePrefix` string, required — The target incoming URL, path, or pattern to match for redirection.
  - `updated` string, date-time, required — The date and time when the URL mapping was last modified.

## Response `200`

successful operation

- UrlMapping
  - `created` string, date-time, required — The date and time when the URL mapping was initially created.
  - `destination` string, required — The destination URL, where the target URL should be redirected if it matches the `routePrefix`.
  - `id` string, required — The unique ID of this URL redirect.
  - `isMatchFullUrl` boolean, required — Whether the `routePrefix` should match on the entire URL, including the domain.
  - `isMatchQueryString` boolean, required — Whether the `routePrefix` should match on the entire URL path, including the query string.
  - `isOnlyAfterNotFound` boolean, required — Whether the URL redirect mapping should apply only if a live page on the URL isn't found. If False, the URL redirect mapping will take precedence over any existing page.
  - `isPattern` boolean, required — Whether the `routePrefix` should match based on pattern.
  - `isProtocolAgnostic` boolean, required — Whether the `routePrefix` should match both HTTP and HTTPS protocols.
  - `isTrailingSlashOptional` boolean, required — Whether a trailing slash will be ignored.
  - `precedence` integer, required — Used to prioritize URL redirection. If a given URL matches more than one redirect, the one with the **lower** precedence will be used.
  - `redirectStyle` integer, required — The type of redirect to create. Options include: 301 (permanent), 302 (temporary), or 305 (proxy). Find more details [here](https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page).
  - `routePrefix` string, required — The target incoming URL, path, or pattern to match for redirection.
  - `updated` string, date-time, required — The date and time when the URL mapping was last modified.

## Other responses

- `default` — An error occurred.

## Changes

- **2026-07-13** (v3) `c73547584248` — 1 info
  - endpoint added
- **2026-06-04** (v3) `bcf56670c0dd` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hubspot/apis/cms-url-redirects/changes/cms/url-redirects/2026-09/:urlRedirectId/patch.md)

---

[API](https://skmtc.dev/hubspot/apis/cms-url-redirects.md) · [All operations](https://skmtc.dev/hubspot/apis/cms-url-redirects/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hubspot/cms-url-redirects/revisions/c73547584248/schema)