PodsDomains

Update Domain

CLI:

agentmail pods:domains update --pod-id <pod_id> --domain-id <domain_id>

patch/v0/pods/{pod_id}/domains/{domain_id}

Path parameters

pod_idstring required

ID of pod.

domain_idstring required

The ID of the domain.

Request body

feedback_enabledboolean

Bounce and complaint notifications are sent to your inboxes.

subdomains_enabledboolean

Allow inboxes on any subdomain of this domain. Adds a required wildcard MX record (*.<domain>) to records.

Response

pod_idstring

ID of pod.

domain_idstring required

The ID of the domain.

domainstring required

The name of the domain (e.g., example.com).

feedback_enabledboolean required

Bounce and complaint notifications are sent to your inboxes.

subdomains_enabledboolean required

Allow inboxes on any subdomain of this domain. Adds a required wildcard MX record (*.<domain>) to records.

client_idstring

Client ID of domain.

updated_atstring date-time required

Time at which the domain was last updated.

created_atstring date-time required

Time at which the domain was created.

Changes

Changed in 5 of the 34 revisions of this API.214

Jul 15, 2026394ddcdd9c295See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
Mar 31, 202627965096e6181See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 28, 20268a5b5e92ae2d1See the full diff
- ▲
  api removed without deprecation
  api-removed-without-deprecation
This revision also has 28 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 19, 20267fdcd6b4651f17See the full diff
- ▲
  the response's property type changed from string to no type for status
  response-property-type-changed
- ○
  removed the FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NOT_STARTED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PENDING enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the VERIFIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the VERIFYING enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  added the required property to the response with the status
  response-required-property-added
Mar 9, 2026b1919d0d52ac1See the full diff
- ○
  endpoint added
  endpoint-added

Full history