Agent Burner

Disposable email API. Use when you need a temporary email address -- receiving mail, reading contents, extracting URLs. Triggers include "create a temp email", "I need a burner email", "disposable inbox", or any task requiring a throwaway email address.

Disposable email API. No signup, no API key.

Quick Start

bash

# create an inbox
curl -X POST https://api.agentburner.com/inbox
# -> { "address": "[e-mail]", "key": "550e8400-...", "ttl": 3600 }

# read emails
curl https://api.agentburner.com/inbox/550e8400-...
# -> { "address": "...", "entries": [{ "id": "...", "from": "...", "subject": "...", "receivedAt": "..." }] }

# get full email
curl https://api.agentburner.com/inbox/550e8400-.../EMAIL_ID
# -> { "body": "...", "html": "...", "urls": ["..."], ... }

# delete inbox (optional -- auto-expires)
curl -X DELETE https://api.agentburner.com/inbox/550e8400-...

API Reference

POST /inbox

Create a disposable inbox.

text

Body (optional): { "ttl": 60 }   // TTL in minutes, default 60, max 360
Response: { "address": string, "key": string, "ttl": number }

• address -- the email address
• key -- inbox key (UUID), the only credential you need
• ttl -- inbox lifetime in seconds

Rate limited to 10 creations per minute per IP.

GET /inbox/:key

List received emails.

text

Response: { "address": string, "entries": [{ "id": string, "from": string, "subject": string, "receivedAt": string }] }

Returns 404 if key is expired or invalid.

GET /inbox/:key/:emailId

Get full email content.

text

Response: {
  "id": string,
  "from": string,
  "to": string[],
  "subject": string,
  "body": string,        // plain text
  "html": string | null, // raw HTML if present
  "urls": string[],      // all extracted URLs
  "receivedAt": string   // ISO 8601
}

DELETE /inbox/:key

Delete inbox and all emails. Optional -- inboxes auto-expire.

text

Response: { "ok": true }

Key Details

• No auth required -- inbox key is the only credential
• Multiple trusted .com domains
• Auto-expiry -- 1 hour default, 6 hours max
• 50 emails per inbox (oldest dropped first)
• 10MB max email size
• URLs extracted from both HTML and plain text

Errors

Status	Meaning
404	Key expired or invalid
429	Rate limit exceeded