# renew-mailbox

Paid (x402, $9.99/yr fixed — operator-configurable). Extends a managed mailbox by one year from the later of now / current expiry.

## Input

| Field | Required | Notes |
|---|---|---|
| `address` | yes | A mailbox managed by this provider. |

Envelope auth required. **Any-payer policy**: the payer does not have to be the owner (extending someone's mailbox only benefits them) — the mailbox just has to exist here.

## Semantics

- `active` → expiry extended one year.
- `expired` (within the 30-day grace window) → expiry extended, **sending re-enabled**, state back to `active`. Stored mail was never deleted during grace; reading kept working the whole time.
- `suspended` (abuse) → expiry extended, but sending stays blocked — only the operator can lift a suspension.
- `deleted` → fails. Re-register with `create-mailbox`; old mail is gone.

## Result artifact — `mailbox_renewed`

```jsonc
{ "address": "scout@agentmail.example", "expiresAt": "2028-07-02T…", "restored": true }
```