{"uid":"cap_BiAbeEimMh-tnsp0IqtS5","slug":"mermail-mailbox-attachment-retrieval-ae801baa","name":"Mermail Mailbox Attachment Retrieval","description":"An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.","url":"https://console.mermail.app/api/agent/v1/mailboxes/%7BmailboxId%7D/attachments/%7BattachmentId%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"id":{"type":"string"},"size":{"type":"integer"},"filename":{"type":"string"},"mimetype":{"type":"string"},"content_omitted":{"type":"boolean"},"content_omission_reason":{"type":"string"}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"id":"att_1","size":1024,"filename":"invoice.pdf","mimetype":"application/pdf"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_ubf0m16Rm4TQaUuyiN8Os","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves metadata and details for a specific email attachment within an AI agent's Mermail mailbox","exampleAgentPrompt":"Fetch the attachment details for attachment att_1 from mailbox mbx_42 in my Mermail agent inbox — I need the filename, MIME type, and size.","exampleUseCases":[{"title":"Invoice retrieval from support email","prompt":"Grab the invoice PDF attachment from mailbox mbx_sales in my Mermail inbox — the attachment ID is att_88 — and tell me the filename and file size."},{"title":"Lead attachment review","prompt":"My Mermail agent mailbox received a sales lead email with an attachment att_23 in mailbox mbx_leads — can you fetch the attachment info so I know what file type it is?"},{"title":"Customer support document check","prompt":"Check attachment att_55 in my Mermail support mailbox mbx_support — I need to know the filename and whether the content was omitted before I process it."}],"resultDescription":"A JSON object containing the attachment's ID, filename, MIME type, file size in bytes, and flags indicating whether content was omitted and the reason for omission if applicable.","failureModes":["Invalid or non-existent mailboxId returns a 404 error","Invalid or non-existent attachmentId returns a 404 error","Unauthorized access to a mailbox returns a 401 or 403 error","Content may be omitted from the response if the attachment is too large or restricted, indicated by content_omitted flag","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when your AI agent needs to inspect or retrieve metadata about a specific email attachment within a Mermail-managed mailbox, particularly when processing inbound emails for sales lead nurturing, customer support workflows, or purchase-related document handling. Prefer this over generic file storage APIs when the attachment is already associated with a Mermail mailbox message.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:45:04.655Z","isFirstParty":false,"canonicalSlug":"mermail-mailbox-attachment-retrieval-ae801baa"}