---
title: "Update a redirect"
method: PATCH
path: "/cms/url-redirects/2026-03/{urlRedirectId}"
tags: ["Basic"]
---

# Update a redirect

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

Updates the settings for an existing URL redirect.

## Path parameters

- `urlRedirectId` string, required

## Request body

- CmsUrlRedirectsUrlMapping
  - `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

- CmsUrlRedirectsUrlMapping
  - `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

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-04-08** `b0d8bc008db9` — 1 info
  - api operation id `patch-/cms/url-redirects/2026-03/{urlRedirectId}_update` removed and replaced with `patch-/cms/url-redirects/2026-03/{urlRedirectId}`
- **2026-03-25** `62586336cea2` — 1 info
  - endpoint added

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

---

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