{"uid":"cap_0OCbHG8JM_KTVlZnLLO1B","slug":"agentmail-pods-e7a427ee","name":"AgentMail List Pods","description":"List Pods","url":"https://mpp.api.agentmail.to/v0/pods?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"ascending":{"type":"boolean","title":"Ascending","description":"Sort in ascending temporal order."},"page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"responseSchema":{"type":"object","title":"ListPodsResponse","required":["count","pods"],"properties":{"pods":{"type":"array","items":{"type":"object","title":"Pod","required":["pod_id","name","updated_at","created_at"],"properties":{"name":{"type":"string","title":"Name","description":"Name of pod."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"client_id":{"type":"string","title":"ClientId","description":"Client ID of pod."},"created_at":{"type":"string","format":"date-time","description":"Time at which pod was created."},"updated_at":{"type":"string","format":"date-time","description":"Time at which pod was last updated."}}},"description":"Ordered by `created_at` descending."},"count":{"type":"integer","title":"Count","description":"Number of items returned."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"next_page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"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":"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":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_tQxED63fpzBV_b8GswFAT","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Lists all pods (top-level organizational units) in an AgentMail account with pagination support","exampleAgentPrompt":"Show me all my AgentMail pods — list up to 20, sorted by newest first.","exampleUseCases":null,"resultDescription":"Returns an array of pod objects each containing pod_id, name, client_id, created_at, and updated_at timestamps, along with the total count of items returned, the applied limit, and a next_page_token for fetching subsequent pages if more pods exist.","failureModes":["Missing or invalid Authorization header returns 401 Unauthorized","Invalid page_token returns 400 Bad Request or empty result","Non-integer limit value returns 400 validation error","Expired or revoked API key returns 403 Forbidden","Network timeout returns 5xx server error"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate all pods associated with an AgentMail account, especially before performing operations on specific pods (like creating inboxes or managing domains). Prefer this when paginating through large pod collections or when you need to find a pod_id by name.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:35:31.060Z","isFirstParty":false,"canonicalSlug":"agentmail-pods-e7a427ee"}