Skip to main content
The hosted TempInbox service has no supported public automation API. These implementation examples are for an instance you operate and must be checked against its deployed version, authentication, inbound mail routing, and rate limits. Do not export hosted browser access tokens for CI. For hosted manual use, see QA workflows.
The session system lets users keep multiple inboxes active simultaneously (up to 3). It uses an HMAC-signed session_id cookie stored in Cloudflare KV.
Session endpoints are designed for browser clients. For API automation, track JWTs per address directly instead of using session management.

List session addresses

GET /api/session/addresses Returns all addresses in the current session and which one is active.
Response

Switch active address

POST /api/switch_address Switches the active inbox. Updates the jwt cookie to the JWT for the selected address. Also rotates the session_id for security.
Response

Logout

POST /api/logout Deletes the session from KV storage and clears jwt and session_id cookies.
Response