{"uid":"cap_7Dlyqjtp92o7HRPusAxMP","slug":"agentmail-metrics-cca73602","name":"AgentMail Query Pod Metrics","description":"Query Metrics","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/metrics?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["pod_id"],"properties":{"end":{"type":"string","title":"End","format":"date-time","description":"End timestamp for the query."},"limit":{"type":"integer","title":"MetricLimit","description":"Limit on number of buckets to return."},"start":{"type":"string","title":"Start","format":"date-time","description":"Start timestamp for the query."},"period":{"type":"string","title":"Period","description":"Period in number of seconds for the query."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"descending":{"type":"boolean","title":"Descending","description":"Sort in descending order."},"event_types":{"type":"array","items":{"enum":["message.sent","message.delivered","message.bounced","message.delayed","message.rejected","message.complained","message.received"],"type":"string","title":"MetricEventType","description":"Type of metric event."},"title":"MetricEventTypes","description":"List of metric event types to query."}}},"responseSchema":{"type":"object","title":"QueryMetricsResponse","description":"Metrics grouped by event type.","additionalProperties":{"type":"array","items":{"type":"object","title":"MetricBucket","required":["timestamp","count"],"properties":{"count":{"type":"integer","description":"Count of events in the bucket."},"timestamp":{"type":"string","format":"date-time","description":"Timestamp of the bucket."}}}}},"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 time-bucketed email event metrics (sent, delivered, bounced, etc.) for a specific AgentMail pod over a configurable time window.","exampleAgentPrompt":"Show me the email metrics for pod 'pod_abc123' over the last 7 days — I want to see message.sent, message.delivered, and message.bounced events grouped into 1-hour buckets (3600 seconds), limited to 168 results, in ascending order.","exampleUseCases":null,"resultDescription":"A JSON object keyed by event type (e.g. 'message.sent', 'message.bounced'), where each value is an array of time-bucketed metric objects containing a timestamp and a count of events in that period. This allows the agent to analyze email delivery trends, bounce rates, and engagement over time.","failureModes":["Missing or invalid pod_id returns 404 Not Found","Invalid or missing Authorization header returns 401 Unauthorized","Invalid date-time format for start/end returns 422 Unprocessable Entity","Unsupported event_type enum value returns 422 Unprocessable Entity","period value of zero or negative returns 400 Bad Request","No data in the requested range returns an empty object or empty arrays","Rate limiting may return 429 Too Many Requests"],"whenToPreferThis":"Use this endpoint when you need time-series analytics on email activity for a specific AgentMail pod — particularly for monitoring delivery health, detecting bounce spikes, auditing send volumes, or building dashboards. Prefer this over general inbox listing endpoints when you need aggregated counts over time rather than individual message details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:44:26.107Z","isFirstParty":false,"canonicalSlug":"agentmail-metrics-cca73602"}