{"uid":"cap_2zpnZlyfhu2kuksF4WF1e","slug":"agentmail-list-pod-threads-31b5b238","name":"AgentMail List Pod Threads","description":"AgentMail gives AI agents real email inboxes. Create, send, receive, and search messages via REST API — built for autonomous agents and agentic workflows.","url":"https://x402.api.agentmail.to/v0/pods/%7Bpod_id%7D/threads","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["pod_id"],"properties":{"pod_id":{"type":"string"}},"additionalProperties":false},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","additionalProperties":true}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"free","summary":"Free","primary":{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_HjNv7s1Uay53zCUklX0za","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":"Lists all email threads belonging to a specific AgentMail pod (inbox container) for AI agents","exampleAgentPrompt":"Show me all the email threads in AgentMail pod 'pod_abc123' so I can see what conversations my agent has been having.","exampleUseCases":[{"title":"Monitor agent support conversations","prompt":"Pull up all the email threads in our support agent's inbox pod so I can review which customer issues my agent has been handling."},{"title":"Audit agent inbox for compliance","prompt":"Fetch me the complete list of email threads from the compliance monitoring pod so I can check what communications have been logged."},{"title":"Triage incoming agent messages","prompt":"Show me all conversation threads in my agent's inbox pod so I can prioritize which ones need immediate escalation to a human."}],"resultDescription":"A JSON list of email threads associated with the specified pod, including thread identifiers, participants, subject lines, and message metadata for each conversation thread.","failureModes":["pod_id not found — 404 Not Found","missing pod_id path parameter — 400 Bad Request","unauthorized access to pod — 401 Unauthorized","pod has no threads — empty array returned","rate limit exceeded — 429 Too Many Requests"],"whenToPreferThis":"Use this endpoint when you need to enumerate all email conversation threads within a specific AgentMail pod. Prefer this over the workspace-level threads endpoint when you want thread data scoped to a single pod/inbox rather than the entire workspace. Ideal for agentic workflows that monitor or process email conversations within a dedicated agent inbox.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:45:24.209Z","isFirstParty":false}