# Update an address

> Change an address's endpoint route or active state.

`PATCH https://inboundr.net/api/v1/addresses/{id}`

Repoints an address to a different [endpoint](/concepts/endpoints) (or makes it
store-only), and/or toggles whether it's active. Provide at least one field.

<ParamField path="id" type="string" required>
  The address id (`addr_…`).
</ParamField>
<ParamField body="endpointId" type="string | null">
  A webhook endpoint (`ep_…`) to deliver to, or `null` to make the address
  store-only. Must be an endpoint you own.
</ParamField>
<ParamField body="active" type="boolean">
  Whether the address accepts mail.
</ParamField>

<ResponseExample>
```json 200
{
  "id": "addr_123",
  "domainId": "dom_123",
  "localPart": "support",
  "endpointId": null,
  "active": true,
  "createdAt": "2026-07-20T10:00:00.000Z",
  "domain": "yourdomain.com",
  "address": "support@yourdomain.com"
}
```
</ResponseExample>

<Note>
  Returns `400` if `endpointId` is unknown, or `404` if the address isn't yours.
</Note>