# Update a redirect rule

Updates an existing redirect rule. Only include the fields you wish to update.

If fromUrl is provided, it will be re-normalized and validated against the Help Center's custom domain. If targetType or targetId is changed, the new target must exist and have a resolvable URL.

### Path Parameters

- id - The unique identifier of the redirect rule to update

### Request Body

All fields are optional. Only provided fields will be updated:
- helpCenterId - The help center ID
- locale - Locale code
- fromUrl - Updated source URL (will be re-normalized)
- targetType - "article" or "collection"
- targetId - ID of the new target article or collection

### Response

Returns the updated redirect rule object.

### Errors

- 404 - Redirect rule not found
- 400 - Invalid data, domain mismatch, duplicate fromUrl, or target not found

Endpoint: PATCH /v2/help_center/redirect_rules/{id}
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Path parameters:

  - `id` (string, required)
    Redirect rule unique identifier
    Example: "507f1f77bcf86cd799439011"

## Request fields (application/json):

  - `helpCenterId` (string)
    Help center identifier
    Example: "ox6qrqprmsuqaunj"

  - `locale` (string)
    Locale code for the redirect rule
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `fromUrl` (string)
    Full absolute URL to redirect from. Must use http or https protocol. Query parameters and hash fragments are stripped during normalization. The hostname must match the Help Center custom domain.
    Example: "https://help.example.com/en/old/getting-started"

  - `targetType` (string)
    Type of content the redirect points to
    Enum: "article", "collection"

  - `targetId` (string)
    ID of the target article or collection
    Example: "10021362"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "redirect_rule"

  - `id` (string, required)
    Redirect rule unique identifier
    Example: "507f1f77bcf86cd799439011"

  - `helpCenterId` (string, required)
    Help center identifier
    Example: "ox6qrqprmsuqaunj"

  - `locale` (string, required)
    Locale code for the redirect rule
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `fromUrl` (string, required)
    Canonical source URL being redirected from (query and hash stripped)
    Example: "https://help.example.com/en/old/getting-started"

  - `targetType` (string, required)
    Type of content the redirect points to
    Enum: "article", "collection"

  - `targetId` (string, required)
    Target article or collection ID
    Example: "1234567"

  - `createdAt` (string, required)
    ISO 8601 timestamp when created
    Example: "2026-02-11T12:00:00.000Z"

  - `updatedAt` (string, required)
    ISO 8601 timestamp when last updated
    Example: "2026-02-11T12:00:00.000Z"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_id", "business_validation_error", "resource_not_found"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "redirect_rule_not_found"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 404