# Update a single forward rule by ID

All parameters are optional; only the provided fields will be updated. Submit an explicit empty value for `forward.recipient` or `forward.url` to clear that destination type. A rule must retain at least one forwarding action.

Endpoint: PUT /v3/forwards/{id}
Version: 3.0.0
Security: basicAuth

## Security:

  - `basicAuth` (unknown)
    http basic

## Path parameters:

  - `id` (string, required)
    The ID of the forward rule

## Query parameters:

  - `match` (string)
    A wildcard expression which matches the recipient address to forward. This is an insensitive match address

  - `forward.url` (string)
    A URL to forward when the rule matches the recipient. May be repeated up to 3 times. Must be a valid URL that resolves. Submit an explicit empty value to clear all URL destinations.

  - `forward.recipient` (string)
    An email address to forward to when the rule matches the recipient. May be repeated up to 5 times. Submit an explicit empty value to clear all recipient destinations.

  - `forward.store` (string)
    A URL which will be used to notify you when the email arrives along with a URL you can use to retrieve the message. Must be a valid URL that resolves. Submit an explicit empty value to clear the store destination.

## Response 200:

  - `200` (unknown)
    A 200 response

## Response 200 fields (application/json):

  - `id` (string, required)

  - `account_id` (string, required)

  - `domain_name` (string, required)

  - `domain_id` (string, required)

  - `match` (string, required)

  - `forward` (object, required)

  - `forward.urls` (array, required)

  - `forward.recipients` (array)

  - `forward.store` (string)

  - `created_at` (string, required)

  - `updated_at` (string, required)

## Response 400:

  - `400` (unknown)
    A 400 response

## Response 400 fields (application/json):

  - `message` (string, required)
    Response message

## Response 401:

  - `401` (unknown)
    A 401 response

## Response 401 fields (application/json):

  - `message` (string, required)
    Response message

## Response 404:

  - `404` (unknown)
    A 404 response

## Response 404 fields (application/json):

  - `message` (string, required)
    Response message

## Response 500:

  - `500` (unknown)
    A 500 response

## Response 500 fields (application/json):

  - `message` (string, required)
    Response message

## Response 200 examples:

  - `Example` (unknown)