Update Domain | AgentMail

{
  "domain_id": "domain_id",
  "domain": "domain",
  "status": "NOT_STARTED",
  "feedback_enabled": true,
  "subdomains_enabled": true,
  "tracking_enabled": true,
  "records": [
    {
      "type": "TXT",
      "name": "name",
      "value": "value",
      "status": "MISSING",
      "priority": 1,
      "reason": "reason"
    },
    {
      "type": "TXT",
      "name": "name",
      "value": "value",
      "status": "MISSING",
      "priority": 1,
      "reason": "reason"
    }
  ],
  "updated_at": "2024-01-15T09:30:00Z",
  "created_at": "2024-01-15T09:30:00Z",
  "pod_id": "pod_id",
  "reason": "reason",
  "client_id": "client_id"
}

CLI:

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

**CLI:** ```bash agentmail pods domains update --pod-id <pod_id> --domain-id <domain_id> ```

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

pod_idstringRequired

ID of pod.

domain_idstringRequired

The ID of the domain.

Request

This endpoint expects an object.

feedback_enabledbooleanOptional

Bounce and complaint notifications are sent to your inboxes.

subdomains_enabledbooleanOptional

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

tracking_enabledbooleanOptional

Serve open tracking pixels from this domain. Adds a required link.<domain> CNAME record to records, which must be published and verified before track_opens can be used on a send.

Response

This endpoint returns an object.

domain_idstring

The ID of the domain.

domainstring

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

statusenum

The verification status of the domain.

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.

tracking_enabledboolean

Serve open tracking pixels from this domain. Adds a required link.<domain> CNAME record to records, which must be published and verified before track_opens can be used on a send.

recordslist of objects

A list of DNS records required to verify the domain. Includes a wildcard MX record (*.<domain>) when subdomains_enabled is true.

updated_atdatetime

Time at which the domain was last updated.

created_atdatetime

Time at which the domain was created.

pod_idstringOptional

ID of pod.

reasonstringOptional

Why the domain is not (yet) VERIFIED, when known. dns_records_missing / dns_records_invalid point at the DNS records. The ses_* values mean the records look right and sending-infrastructure validation has not converged: ses_dkim_pending / ses_mail_from_pending (still checking), ses_dkim_temporary_failure / ses_mail_from_temporary_failure (a transient error the infrastructure keeps retrying on its own — usually resolves without changes), ses_dkim_failed / ses_mail_from_failed (a terminal verdict; re-verify after fixing), ses_dkim_not_started / ses_mail_from_not_started (the attribute was never configured on the identity — re-verify to push it), and ses_not_verified_for_sending. Absent when VERIFIED.

client_idstringOptional

Client ID of domain.

Errors

404

Not Found Error