{"uid":"cap_DYpiLVQuXq17-b9W108tD","slug":"agentmail-domain-id-0bada1f8","name":"AgentMail Update Domain","description":"Update Domain","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/domains/:domain_id?utm_source=zero.xyz","method":"PATCH","headers":{},"bodySchema":{"type":"object","title":"UpdateDomainRequest","properties":{"feedback_enabled":{"type":"boolean","title":"FeedbackEnabled","description":"Bounce and complaint notifications are sent to your inboxes."}}},"responseSchema":{"type":"object","title":"Domain","required":["domain_id","status","feedback_enabled","records","updated_at","created_at"],"properties":{"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"status":{"enum":["NOT_STARTED","PENDING","INVALID","FAILED","VERIFYING","VERIFIED"],"type":"string","title":"VerificationStatus"},"records":{"type":"array","items":{"type":"object","title":"VerificationRecord","required":["type","name","value","status"],"properties":{"name":{"type":"string","description":"The name or host of the record."},"type":{"enum":["TXT","CNAME","MX"],"type":"string","title":"RecordType"},"value":{"type":"string","description":"The value of the record."},"status":{"enum":["MISSING","INVALID","VALID"],"type":"string","title":"RecordStatus"},"priority":{"type":"integer","description":"The priority of the MX record."}}},"description":"A list of DNS records required to verify the domain."},"client_id":{"type":"string","title":"ClientId","description":"Client ID of domain."},"domain_id":{"type":"string","title":"DomainId","description":"The name of the domain. (e.g., \" your-domain.com\")"},"created_at":{"type":"string","format":"date-time","description":"Time at which the domain was created."},"updated_at":{"type":"string","format":"date-time","description":"Time at which the domain was last updated."},"feedback_enabled":{"type":"boolean","title":"FeedbackEnabled","description":"Bounce and complaint notifications are sent to your inboxes."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"unknown","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Updates configuration settings for a registered email domain within an AgentMail pod, such as enabling or disabling bounce and complaint feedback notifications.","exampleAgentPrompt":"Enable bounce and complaint feedback notifications for the domain 'acme.ai' in my AgentMail pod so that delivery issues get reported to my inboxes.","exampleUseCases":[{"title":"Disable notifications for test domain","prompt":"Turn off bounce and complaint feedback for our staging domain so we don't get alerts during testing and development work."},{"title":"Configure feedback for production email","prompt":"Can you enable bounce and complaint notifications on our production domain acme.com so we catch delivery problems right away?"},{"title":"Manage multiple domain settings","prompt":"I need to toggle feedback notifications off for our old domain and turn them on for our new one to consolidate our email monitoring."}],"resultDescription":"Returns the updated Domain object including domain_id, pod_id, client_id, current verification status (e.g. VERIFIED), the feedback_enabled flag reflecting the new setting, a list of DNS verification records (TXT/CNAME/MX) with their statuses (MISSING/INVALID/VALID), and created_at/updated_at timestamps.","failureModes":["404 Not Found if pod_id or domain_id does not exist","401 Unauthorized if Bearer token is missing or invalid","400 Bad Request if feedback_enabled is not a boolean","403 Forbidden if the caller does not have access to the specified pod or domain","422 Unprocessable Entity if the request body fails schema validation"],"whenToPreferThis":"Use this endpoint when you need to change configuration options on an already-registered domain within an AgentMail pod — specifically to enable or disable bounce and complaint feedback notifications. It is not for registering new domains or verifying DNS records; those are handled by other endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:30:26.477Z","isFirstParty":false,"canonicalSlug":"agentmail-domain-id-0bada1f8"}