{"uid":"cap_GlDnHHh6EQLmlDKUh8RCd","slug":"agentmail-inbox-id-3071dfb9","name":"AgentMail Update Inbox","description":"Update Inbox","url":"https://mpp.api.agentmail.to/v0/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 email inbox by its inbox ID","exampleAgentPrompt":"Update the display name on my AgentMail inbox (inbox ID 'inbox_abc123') to 'Support Bot <support@myagent.agentmail.to>'.","exampleUseCases":[{"title":"Rebrand agent inbox after relaunch","prompt":"We just rebranded our AI assistant from 'HelpBot' to 'Aria'. Can you update the display name on inbox ID 'inbox_xyz789' to 'Aria <aria@mycompany.agentmail.to>' so recipients see the new name?"},{"title":"Rename inbox for new client","prompt":"I'm reassigning inbox ID 'inbox_client42' to handle emails for a new client called Nova Corp. Please update its display name to 'Nova Corp Support <nova@myagent.agentmail.to>'."},{"title":"Update sender name for professionalism","prompt":"The inbox with ID 'inbox_sales99' is still showing a generic name. Change the display name to 'Acme Sales Team <sales@acme.agentmail.to>' so it looks more professional when customers receive emails."}],"resultDescription":"Returns the full updated Inbox object including inbox_id, pod_id, client_id, the new display_name, and timestamps for created_at and updated_at.","failureModes":["inbox_id not found returns 404","missing or invalid Authorization header returns 401","missing required display_name field returns 422 validation error","malformed inbox_id path parameter returns 400"],"whenToPreferThis":"Use this endpoint when you need to change the human-readable display name of an existing AgentMail inbox, such as rebranding an AI agent's email identity or updating the sender name shown in email clients. Prefer this over recreating the inbox when only the display name needs to change.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:51:17.655Z","isFirstParty":false,"canonicalSlug":"agentmail-inbox-id-3071dfb9"}