{"uid":"cap_ih7inIvV8-_Veu9JQXbdF","slug":"agentmail-api-key-03e3030a","name":"AgentMail Delete API Key","description":"Delete API key","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/api-keys/:api_key?utm_source=zero.xyz","method":"DELETE","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":null,"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":"Deletes a specific API key associated with a pod in AgentMail","exampleAgentPrompt":"Please delete the API key 'ak_abc123' from my AgentMail pod 'pod_xyz456' — I want to revoke its access immediately.","exampleUseCases":[{"title":"Revoke compromised API credentials immediately","prompt":"One of our API keys might have been exposed in a recent breach. Please delete the key 'ak_prod_2024' from our main AgentMail pod right away so it can't be misused."},{"title":"Clean up old agent keys during rotation","prompt":"We're rotating our API credentials for security best practices. Can you delete the old key 'ak_legacy_agent' from pod_email_ops? We've already switched to the new one."},{"title":"Deactivate access for decommissioned agents","prompt":"We're shutting down our test agent instance. Please remove its API key 'ak_test_instance_v2' from the pod so it has zero access to AgentMail going forward."}],"resultDescription":"A confirmation that the specified API key has been deleted and is no longer valid for the given pod. Subsequent calls using that key will be rejected.","failureModes":["Pod ID not found — 404 not found response","API key not found within the specified pod — 404 not found response","Unauthorized request — 401 if the caller lacks permission to manage this pod's API keys","Invalid pod_id or api_key format — 400 bad request","Attempting to delete an already-deleted key — may return 404 or idempotent success"],"whenToPreferThis":"Use this endpoint when you need to revoke or remove a specific API key from an AgentMail pod — for example, when rotating credentials, decommissioning an agent, or responding to a security incident involving a compromised key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:45:05.537Z","isFirstParty":false,"canonicalSlug":"agentmail-api-key-f8a111a1"}