{"uid":"cap_4hTQ5k9vO5vFZSU9vvrD-","slug":"agentmail-thread-id-188c3307","name":"AgentMail Get Thread","description":"Get Thread","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/threads/:thread_id?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["inbox_id","thread_id"],"properties":{"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"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":"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":"Retrieves a full email thread by inbox ID and thread ID, including all messages, metadata, labels, senders, and recipients","exampleAgentPrompt":"Pull up the full email thread with ID 'thd_abc123' from inbox 'inbox_xyz456' on AgentMail — I want to see all the messages, who sent them, and any labels on the thread.","exampleUseCases":null,"resultDescription":"Returns a Thread object containing: inbox_id, thread_id, subject, labels array, senders list, recipients list, message count, total size in bytes, preview text of the last message, timestamps (created_at, updated_at), and a full messages array where each message includes from/to/cc/bcc addresses, text and HTML body, attachments, labels, and message-level timestamps.","failureModes":["Invalid inbox_id or thread_id returns 404 not found","Missing or invalid Authorization Bearer token returns 401 unauthorized","Malformed path parameters return 400 bad request","Thread belongs to a different inbox than specified returns 404","Rate limiting may return 429 too many requests"],"whenToPreferThis":"Use this endpoint when you need the complete details of a specific email thread — including all messages, metadata, and labels — and you already know both the inbox_id and thread_id. Prefer this over listing endpoints when you have a specific thread to inspect rather than browsing all threads.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:31:01.170Z","isFirstParty":false,"canonicalSlug":"agentmail-thread-id-188c3307"}