Reference
Changelog
What changed in the /v1 API, newest first. The same list is JSON at https://pidgeon.ai/changelog.json, for a tool to watch. Whether the API is up: https://status.pidgeon.ai.
2026-11-21: Idempotency keys, rate-limit headers, examples, agent identities
- Added.
Idempotency-KeyonPOST /v1/email/inboxes/{id}/messages,POST /v1/email/drafts/{id}/send,POST /v1/email/inboxes/{id}/drafts,POST /v1/email/inboxesandPOST /v1/pods: a retry with the same key and body gets the first answer again, and is never sent or made twice. Keys are kept 24 hours. - Added. Every keyed
/v1answer carriesRateLimitandRateLimit-Policy, andRateLimit-Limit,RateLimit-RemainingandRateLimit-Reset. - Added. Request and response examples on every operation of
GET /v1/openapi.json, which now links the docs, this changelog and the status page. - Added. The webhooks as an AsyncAPI 3.0 document,
/asyncapi.json, and an API catalog at/.well-known/api-catalog. - Added.
agent_idonPATCH /v1/email/inboxes/{id}(admin): link an existing inbox to an agent identity in its pod, ornullto unlink it. In the SDKs asinboxes.setAgentandinboxes.set_agent, and on the MCP server asset_inbox_agent. - Changed. The
/v1/agentsoperations are described as agent identities: who an agent is when it signs mail and signs in.agent_idonPOST /v1/email/inboxeslinks the inbox to one, and stays optional. Paths, fields and answers are unchanged.
2026-11-20: Domains from the API
- Added.
/v1/domains: add a domain, prove it, read its DNS records and remove it, in any pod. - Changed. A key of one pod makes inboxes on, and sends from, its own pod’s domains and
pidgeon.emailonly.
2026-11-19: Pods you can rename, and move things between
- Added.
PATCH /v1/pods/{id}renames a pod. - Added.
POST /v1/pods/{id}/movemoves an inbox, agent, domain, site or webhook into a pod. - Added. A key of one pod adds and removes its own pod’s webhooks.
2026-11-18: Signatures
- Added.
signatureonPATCH /v1/email/inboxes/{id}: added to new mail, replies, forwards and drafts.
2026-11-17: API keys from the API
- Added.
/v1/keys: list, make and revoke API keys.
2026-11-16: Sign in with Pidgeon: sites and test mandates
- Added.
PATCH /v1/auth/clients/{id}andPOST /v1/auth/clients/{id}/rotate-secret. - Changed. A test key asks for a mandate without a verified domain; the mandate and its tokens say
test: true.
2026-11-15: Rename, revoke and remove
- Added.
PATCHandDELETE /v1/agents/{id},DELETE /v1/agents/{id}/keys/{kid}andDELETE /v1/pods/{id}. - Fixed.
POST /v1/email/inboxessays which of not JSON, nonameor a badkindit refused.
2026-11-14: The /v1 API
- Added. Inboxes, sending, drafts and a person’s approval, scheduled send, conversations, labels, search, contacts, attachments, the calendar, mail apps, rules, the do-not-send list, your own domain and test keys.
- Added. Pods, the event log, webhooks, Sign in with Pidgeon sites and mandates, and
GET /v1/openapi.json.