{"uid":"cap_E16ilmdQPAeKV-H3hclMZ","slug":"agentmail-inbox-id-fd0dd15f","name":"AgentMail Update Inbox","description":"Update Inbox","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/inboxes/:inbox_id?utm_source=zero.xyz","method":"PATCH","headers":{},"bodySchema":{"type":"object","title":"UpdateInboxRequest","required":["display_name"],"properties":{"display_name":{"type":"string","title":"DisplayName","description":"Display name: `Display Name <username@domain.com>`."}}},"responseSchema":{"type":"object","title":"Inbox","required":["pod_id","inbox_id","updated_at","created_at"],"properties":{"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"client_id":{"type":"string","title":"ClientId","description":"Client ID of inbox."},"created_at":{"type":"string","format":"date-time","description":"Time at which inbox was created."},"updated_at":{"type":"string","format":"date-time","description":"Time at which inbox was last updated."},"display_name":{"type":"string","title":"DisplayName","description":"Display name: `Display Name <username@domain.com>`."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","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 the display name of a specific inbox within an AgentMail pod","exampleAgentPrompt":"Update my AgentMail inbox 'support-bot' in pod 'prod-pod-01' so its display name shows as 'Support Bot <support-bot@agentmail.to>'.","exampleUseCases":[{"title":"Rebrand support inbox for customer communications","prompt":"I need to change the display name on our support inbox from 'noreply-support' to 'Customer Support Team' so it looks more professional when we send emails to clients."},{"title":"Update agent inbox sender identity","prompt":"Can you rename my agent's email inbox so it shows up as 'Sales Assistant' instead of the technical inbox ID when customers receive replies?"},{"title":"Change inbox display name across pods","prompt":"Update the display name for my support inbox in the production pod to show 'Automated Support <support@company.io>' so customers recognize the sender."}],"resultDescription":"Returns the updated Inbox object with pod_id, inbox_id, client_id, display_name, created_at, and updated_at fields confirming the changes were applied.","failureModes":["Missing required display_name field returns 422 validation error","Invalid pod_id or inbox_id returns 404 not found","Missing or invalid Authorization Bearer token returns 401 unauthorized","Malformed request body returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to update the display name of an existing AgentMail inbox — for example, to change how the sender appears in outgoing emails from an AI agent inbox. It is the only AgentMail endpoint for mutating inbox metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:40:38.774Z","isFirstParty":false,"canonicalSlug":"agentmail-inbox-id-3071dfb9"}