# PUT /api/v1/inboxes/:id/forwarding

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/replace-forwarding

## Summary

Replace the verified auto-forward list. Body is {emails}. Each address must already be verified on this inbox (400 forwarding_not_verified). Pending rows stay. An empty array removes every verified destination. More than 5 destinations, counting pending rows, is 409 forwarding_limit. Write permission is inbox_update. The confirmation code is not accepted.

## Request

```json
{
  "emails": [
    "archive@example.com"
  ]
}
```

## Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

## Errors

- HTTP 400 forwarding_not_verified
- HTTP 409 forwarding_limit

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "invalid_request",
    "code": "forwarding_not_verified",
    "docs_url": "https://cooperemail.com/docs#forwarding_not_verified"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.