Search the docs

Find a page, a section, or an endpoint.

Sign inGet started

Export

Every export endpoint, generated from the API's own schemas.

Export mail as mbox

get/api/v1/export

Every message the key can read, as one `application/mbox` file, streamed — or one address of it with `identity_id`. Each message carries `X-Pidgeon-Mailbox` so a file holding several addresses can be split again; originals are byte for byte where storage still holds them. Four an hour per workspace.

Parameters

  • identity_iduuid

Responses

  • 200The mbox.
  • 401No API key, or one that is not valid.
  • 404No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
  • 429Rate limited. `X-RateLimit-Reset` says when to retry.
bash
curl https://pidgeon.ai/api/v1/export \
  -H "Authorization: Bearer $PIDGEON_API_KEY"

Generated · public/openapi.json