---
title: "Changes to Update Domain"
method: PATCH
path: "/v0/domains/{domain_id}"
---

# Changes to Update Domain

`PATCH /v0/domains/{domain_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 38 revisions.

- **2026-10-28** `4d380313b7be`: 1 warning, 2 info
- **2026-10-16** `3f5c7830c952`: 2 breaking, 11 info
- **2026-07-15** `394ddcdd9c29`: 5 info
- **2026-03-31** `27965096e618`: 1 info
- **2026-03-28** `8a5b5e92ae2d`: 1 breaking
- **2026-03-19** `7fdcd6b4651f`: 1 breaking, 7 info
- **2026-03-09** `b1919d0d52ac`: 1 info

## Changes

- **2026-10-28** `4d380313b7be`: 1 warning, 2 info
  - added the new `CAA` enum value to the `records/items/type` response property for the response status `200`
  - added the optional property `tracking_reason` to the response with the `200` status
  - added the optional property `tracking_status` to the response with the `200` status
- **2026-10-16** `3f5c7830c952`: 2 breaking, 11 info
  - the request property `feedback_enabled` became not nullable
  - the request property `subdomains_enabled` became not nullable
  - the endpoint scheme security `Bearer` was added to the API
  - the endpoint scheme security `BearerAuth` was removed from the API
  - api tag `domains` added
  - api tag `Domains` removed
  - added the new optional request property `inbound_enabled`
  - added the new optional request property `tracking_enabled`
  - request body became optional
  - added the optional property `inbound_enabled` to the response with the `200` status
  - added the optional property `reason` to the response with the `200` status
  - added the optional property `records/items/reason` to the response with the `200` status
  - added the required property `tracking_enabled` to the response with the `200` status
- **2026-07-15** `394ddcdd9c29`: 5 info
  - added the new optional request property `subdomains_enabled`
  - added the optional property `code` to the response with the `404` status
  - added the optional property `docs` to the response with the `404` status
  - added the optional property `fix` to the response with the `404` status
  - added the required property `subdomains_enabled` to the response with the `200` status
- **2026-03-31** `27965096e618`: 1 info
  - endpoint added
- **2026-03-28** `8a5b5e92ae2d`: 1 breaking
  - api removed without deprecation
- **2026-03-19** `7fdcd6b4651f`: 1 breaking, 7 info
  - the `status` response's property type changed from `string` to no type for status `200`
  - removed the `FAILED` enum value from the `status` response property for the response status `200`
  - removed the `INVALID` enum value from the `status` response property for the response status `200`
  - removed the `NOT_STARTED` enum value from the `status` response property for the response status `200`
  - removed the `PENDING` enum value from the `status` response property for the response status `200`
  - removed the `VERIFIED` enum value from the `status` response property for the response status `200`
  - removed the `VERIFYING` enum value from the `status` response property for the response status `200`
  - added the required property `domain` to the response with the `200` status
- **2026-03-09** `b1919d0d52ac`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/agentmail-to/apis/api/docs/v0/domains/:domain_id/patch.md) - [API](https://skmtc.dev/agentmail-to/apis/api.md) - [Page](https://skmtc.dev/agentmail-to/apis/api/changes/v0/domains/:domain_id/patch)