{"uid":"cap_KPFBjvoqyYe7mZ04gAsvI","slug":"agentmail-thread-id-85c186b2","name":"AgentMail Get Thread","description":"Get Thread","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/threads/:thread_id?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["pod_id","thread_id"],"properties":{"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"thread_id":{"type":"string","title":"ThreadId","description":"ID of thread."}}},"responseSchema":{"type":"object","title":"Thread","required":["inbox_id","thread_id","labels","timestamp","senders","recipients","last_message_id","message_count","size","updated_at","created_at","messages"],"properties":{"size":{"type":"integer","title":"ThreadSize","description":"Size of thread in bytes."},"labels":{"type":"array","items":{"type":"string"},"title":"ThreadLabels","description":"Labels of thread."},"preview":{"type":"string","title":"ThreadPreview","description":"Text preview of last message in thread."},"senders":{"type":"array","items":{"type":"string"},"title":"ThreadSenders","description":"Senders in thread. In format `username@domain.com` or `Display Name <username@domain.com>`."},"subject":{"type":"string","title":"ThreadSubject","description":"Subject of thread."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"messages":{"type":"array","items":{"type":"object","title":"Message","required":["inbox_id","thread_id","message_id","labels","timestamp","from","to","size","updated_at","created_at"],"properties":{"cc":{"type":"array","items":{"type":"string"},"title":"MessageCc","description":"Addresses of CC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."},"to":{"type":"array","items":{"type":"string"},"title":"MessageTo","description":"Addresses of recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."},"bcc":{"type":"array","items":{"type":"string"},"title":"MessageBcc","description":"Addresses of BCC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."},"from":{"type":"string","title":"MessageFrom","description":"Address of sender. In format `username@domain.com` or `Display Name <username@domain.com>`."},"html":{"type":"string","title":"MessageHtml","description":"HTML body of message."},"size":{"type":"integer","title":"MessageSize","description":"Size of message in bytes."},"text":{"type":"string","title":"MessageText","description":"Plain text body of message."},"labels":{"type":"array","items":{"type":"string"},"title":"MessageLabels","description":"Labels of message."},"headers":{"type":"object","title":"MessageHeaders","description":"Headers in message.","additionalProperties":{"type":"string"}},"preview":{"type":"string","title":"MessagePreview","description":"Text preview of message."},"subject":{"type":"string","title":"MessageSubject","description":"Subject of message."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"reply_to":{"type":"array","items":{"type":"string"},"description":"Reply-to addresses. In format `username@domain.com` or `Display Name <username@domain.com>`."},"thread_id":{"type":"string","title":"ThreadId","description":"ID of thread."},"timestamp":{"type":"string","title":"MessageTimestamp","format":"date-time","description":"Time at which message was sent or drafted."},"created_at":{"type":"string","title":"MessageCreatedAt","format":"date-time","description":"Time at which message was created."},"message_id":{"type":"string","title":"MessageId","description":"ID of message."},"references":{"type":"array","items":{"type":"string"},"title":"MessageReferences","description":"IDs of previous messages in thread."},"updated_at":{"type":"string","title":"MessageUpdatedAt","format":"date-time","description":"Time at which message was last updated."},"attachments":{"type":"array","items":{"type":"object","title":"Attachment","required":["attachment_id","size"],"properties":{"size":{"$ref":"#/components/schemas/type_attachments:AttachmentSize"},"filename":{"$ref":"#/components/schemas/type_attachments:AttachmentFilename"},"content_id":{"$ref":"#/components/schemas/type_attachments:AttachmentContentId"},"content_type":{"$ref":"#/components/schemas/type_attachments:AttachmentContentType"},"attachment_id":{"$ref":"#/components/schemas/type_attachments:AttachmentId"},"content_disposition":{"$ref":"#/components/schemas/type_attachments:AttachmentContentDisposition"}}},"title":"MessageAttachments","description":"Attachments in message."},"in_reply_to":{"type":"string","title":"MessageInReplyTo","description":"ID of message being replied to."},"extracted_html":{"type":"string","description":"Extracted new HTML content."},"extracted_text":{"type":"string","description":"Extracted new text content."}}},"description":"Messages in thread. Ordered by `timestamp` ascending."},"thread_id":{"type":"string","title":"ThreadId","description":"ID of thread."},"timestamp":{"type":"string","title":"ThreadTimestamp","format":"date-time","description":"Timestamp of last sent or received message."},"created_at":{"type":"string","title":"ThreadCreatedAt","format":"date-time","description":"Time at which thread was created."},"recipients":{"type":"array","items":{"type":"string"},"title":"ThreadRecipients","description":"Recipients in thread. In format `username@domain.com` or `Display Name <username@domain.com>`."},"updated_at":{"type":"string","title":"ThreadUpdatedAt","format":"date-time","description":"Time at which thread was last updated."},"attachments":{"type":"array","items":{"type":"object","title":"Attachment","required":["attachment_id","size"],"properties":{"size":{"type":"integer","title":"AttachmentSize","description":"Size of attachment in bytes."},"filename":{"type":"string","title":"AttachmentFilename","description":"Filename of attachment."},"content_id":{"type":"string","title":"AttachmentContentId","description":"Content ID of attachment."},"content_type":{"type":"string","title":"AttachmentContentType","description":"Content type of attachment."},"attachment_id":{"type":"string","title":"AttachmentId","description":"ID of attachment."},"content_disposition":{"enum":["inline","attachment"],"type":"string","title":"AttachmentContentDisposition","description":"Content disposition of attachment."}}},"title":"ThreadAttachments","description":"Attachments in thread."},"message_count":{"type":"integer","title":"ThreadMessageCount","description":"Number of messages in thread."},"sent_timestamp":{"type":"string","title":"ThreadSentTimestamp","format":"date-time","description":"Timestamp of last sent message."},"last_message_id":{"type":"string","title":"ThreadLastMessageId","description":"ID of last message in thread."},"received_timestamp":{"type":"string","title":"ThreadReceivedTimestamp","format":"date-time","description":"Timestamp of last received message."}}},"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":"Retrieves a full email thread including all messages, metadata, labels, senders, and recipients for a given pod and thread ID","exampleAgentPrompt":"Pull up the full email thread with ID thread_abc123 from pod pod_xyz456 in AgentMail — I want to see all the messages, who sent them, and the subject line.","exampleUseCases":null,"resultDescription":"Returns a Thread object containing: inbox_id, thread_id, subject, labels, preview text of the last message, list of senders and recipients, last_message_id, message count, total size in bytes, created_at and updated_at timestamps, and a full array of Message objects each containing from, to, cc, bcc, html body, text body, size, labels, and timestamps.","failureModes":["Invalid or missing pod_id returns 404 Not Found","Invalid or missing thread_id returns 404 Not Found","Missing or invalid Authorization bearer token returns 401 Unauthorized","Pod does not contain the specified thread returns 404","Network timeout returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need to read the full contents and metadata of a specific email thread within an AgentMail pod, including all messages in the conversation. Prefer this over listing threads when you already have the thread_id and need complete message bodies and attachments rather than just a summary.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:31:38.727Z","isFirstParty":false,"canonicalSlug":"agentmail-thread-id-188c3307"}