# Update URLForwarding

Modifies an existing URL forwarding rule. Changes may take up to 24 hours to fully propagate.

Endpoint: PUT /core/v1/domains/{domainName}/url/forwarding/{host}
Version: 1.3.1
Security: BasicAuth

## Path parameters:

  - `domainName` (string, required)
    DomainName is the domain part of the hostname to forward.
    Example: "example.com"

  - `host` (string, required)
    The full hostname, including subdomain.
    Example: "www.example.org"

## Request fields (application/json):

  - `forwardsTo` (string, required)
    The destination URL to which this hostname will be forwarded.
    Example: "https://destination-site.com"

  - `meta` (string,null)
    Meta tags to include in the HTML page when using "masked" forwarding.
Ignored for other forwarding types.
Example: ``
    Example: "<meta name='keywords' content='website, forwarding, masked'>"

  - `title` (string,null)
    The title to be used for the HTML page when using "masked" forwarding.
Ignored for other forwarding types.
    Example: "Welcome to my forwarded website"

  - `type` (string, required)
    The type of URL forwarding. Valid values:
  - : Retains the original domain in the address bar, preventing the user from seeing the actual destination URL. Sometimes called iframe forwarding.
  - : Uses a standard HTTP redirect (301), which changes the address bar to the destination URL.
  - : Uses a temporary HTTP redirect (302), which changes the address bar to the destination URL but indicates the resource is temporarily located elsewhere.
    Enum: "masked", "redirect", "302"

## Response 200 fields (application/json):

  - `domainName` (string)
    The domain name (without subdomains) that is being forwarded.
    Example: "example.org"

  - `forwardsTo` (string, required)
    The destination URL to which this hostname will be forwarded.
    Example: "https://destination-site.com"

  - `host` (string, required)
    The subdomain portion of the hostname that is being forwarded.
    Example: "www.example.org"

  - `meta` (string,null)
    Meta tags to include in the HTML page when using "masked" forwarding.
Ignored for other forwarding types.
Example: ``
    Example: "<meta name='keywords' content='website, forwarding, masked'>"

  - `title` (string,null)
    The title to be used for the HTML page when using "masked" forwarding.
Ignored for other forwarding types.
    Example: "Welcome to my forwarded website"

  - `type` (string, required)
    The type of URL forwarding. Valid values:
  - : Retains the original domain in the address bar, preventing the user from seeing the actual destination URL. Sometimes called iframe forwarding.
  - : Uses a standard HTTP redirect (301), which changes the address bar to the destination URL.
  - : Uses a temporary HTTP redirect (302), which changes the address bar to the destination URL but indicates the resource is temporarily located elsewhere.
    Enum: "masked", "redirect", "302"

## Response 400 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Bad Request"

  - `details` (string,null)
    Additional context or information about the error
    Example: "'domainName' cannot be null"

## Response 401 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Unauthorized"

## Response 403 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Permission denied"

  - `details` (string,null)
    Additional context or information about the error
    Example: "Failed authentication"

## Response 404 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Not Found"

  - `details` (string,null)
    Additional context or information about the error
    Example: "The requested domain does not exist."

## Response 415 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "The 'Content-Type' header must be 'application/json' for this request."

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"

## Response 500 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error.
    Example: "Internal Server Error"

  - `details` (string,null)
    Additional context or information about the error.
    Example: "Something went wrong."