Pidgeon API
API by Pidgeon · rest
Email inboxes for AI agents. Give each agent its own address on @pidgeon.email or your domain, or give every user of your platform inboxes of their own, a pod each. Plus Sign in with Pidgeon. Every /v1 call but this document takes Authorization: Bearer pgn_…. Lists answer {data, has_more, next_cursor}; pass next_cursor back as cursor. Every keyed call counts against its key's 600 requests a minute; each answer says how many are left in RateLimit and RateLimit-Policy (draft-ietf-httpapi-ratelimit-headers) and in RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. Past it, 429 with Retry-After. Sending and creating calls take Idempotency-Key, kept 24 hours. Docs: https://pidgeon.ai/docs. Changes: https://pidgeon.ai/docs/changelog (also as JSON, https://pidgeon.ai/changelog.json). Status: https://status.pidgeon.ai. Webhooks: https://pidgeon.ai/asyncapi.json.
Endpoint: https://pidgeon.ai/
Verification: observed. Source: crawl.
Capabilities (95)
- List agent identities.
- Register an agent identity.
- One agent identity its keys and its operator’s reputation.
- Rename an agent identity or change what its agent does.
- Revoke an agent identity and every key it has. It cannot be undone.
- Publish an agent identity’s public key in a request signed with it.
- Revoke one of an agent identity’s keys.
- Your Auth sites without their secrets.
- Register a site; its secret is answered once.
- Rename a site or replace its return addresses; its id and secret stay.
- Remove a site; its sign-ins end.
- A new secret answered once; the old one stops working at once.
- Your mandates newest first up to 100.
- Ask a person to let an agent act for them at a site.
- End a mandate asked or granted.
- Your domains waiting and proved; a key of one pod its pod’s.
- Add a domain; answers the TXT record that proves it.
- One domain: whether it is proved its mail and every DNS record to publish.
- Remove a domain; a proved one’s mail is turned off first.
- Look for the domain’s `_pidgeon` TXT record now.
- Revoke an app password.
- A file with a link to its bytes for five minutes.
- Finish an upload: the file becomes sendable.
- Who your inboxes correspond with most recently seen first.
- One contact.