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-Key on POST /v1/email/inboxes/{id}/messages, POST /v1/email/drafts/{id}/send, POST /v1/email/inboxes/{id}/drafts, POST /v1/email/inboxes and POST /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 /v1 answer carries RateLimit and RateLimit-Policy, and RateLimit-Limit, RateLimit-Remaining and RateLimit-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_id on PATCH /v1/email/inboxes/{id} (admin): link an existing inbox to an agent identity in its pod, or null to unlink it. In the SDKs as inboxes.setAgent and inboxes.set_agent, and on the MCP server as set_inbox_agent.
  • Changed. The /v1/agents operations are described as agent identities: who an agent is when it signs mail and signs in. agent_id on POST /v1/email/inboxes links 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.email only.

2026-11-19: Pods you can rename, and move things between

  • Added. PATCH /v1/pods/{id} renames a pod.
  • Added. POST /v1/pods/{id}/move moves 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. signature on PATCH /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} and POST /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. PATCH and DELETE /v1/agents/{id}, DELETE /v1/agents/{id}/keys/{kid} and DELETE /v1/pods/{id}.
  • Fixed. POST /v1/email/inboxes says which of not JSON, no name or a bad kind it 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.