# 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.

Source: https://pidgeon.ai/docs/changelog

## 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`.
