{
  "schema_version": "1.0",
  "name": "Reseev",
  "description": "Instant, zero-friction email identity for AI agents. Create a working email address with a single HTTP POST. No signup, no API keys, no human-in-the-loop.",
  "url": "https://reseev.dev",
  "logo": "https://reseev.dev/logo.svg",
  "contact": "hello@reseev.dev",
  "capabilities": [
    "email-send",
    "email-receive",
    "webhook-push",
    "attachment-support"
  ],
  "authentication": {
    "type": "bearer",
    "note": "Token returned on mailbox creation. No pre-registration required.",
    "create_endpoint": "POST https://api.reseev.dev/v1/mailboxes",
    "create_requires_auth": false
  },
  "api": {
    "base_url": "https://api.reseev.dev/v1",
    "documentation": "https://reseev.dev/llms.txt",
    "openapi_spec": "https://api.reseev.dev/v1/openapi.yaml",
    "content_type": "application/json",
    "endpoints": [
      {
        "method": "POST",
        "path": "/mailboxes",
        "auth": false,
        "description": "Create a new mailbox. Returns email address and bearer token.",
        "request_body": {
          "name": "(optional) string — custom local part prefix"
        },
        "response": {
          "id": "string — mailbox ID",
          "address": "string — full email address (e.g. k8v2x9@reseev.dev)",
          "token": "string — bearer token for all subsequent requests",
          "expires_at": "string — ISO8601 expiration timestamp",
          "limits": {
            "sends_per_day": "number",
            "receives_per_day": "number"
          }
        }
      },
      {
        "method": "POST",
        "path": "/send",
        "auth": true,
        "description": "Send an email from your mailbox.",
        "request_body": {
          "to": "string or string[] — recipient(s)",
          "subject": "string — email subject",
          "text": "string — plain text body (at least one of text/html required)",
          "html": "string — HTML body (at least one of text/html required)",
          "cc": "(optional) string[] — CC recipients",
          "bcc": "(optional) string[] — BCC recipients",
          "reply_to": "(optional) string — reply-to address"
        }
      },
      {
        "method": "GET",
        "path": "/mailboxes/:id/messages",
        "auth": true,
        "description": "List received messages in your mailbox.",
        "query_params": {
          "cursor": "(optional) pagination cursor",
          "limit": "(optional) max messages, default 20, max 100",
          "since": "(optional) ISO8601 timestamp — only messages after this time"
        }
      },
      {
        "method": "GET",
        "path": "/mailboxes/:id/messages/:msg_id",
        "auth": true,
        "description": "Get a single message with full body and attachment metadata."
      },
      {
        "method": "PUT",
        "path": "/mailboxes/:id/webhook",
        "auth": true,
        "description": "Register a webhook URL. We POST to it on every incoming email.",
        "request_body": {
          "url": "string — HTTPS URL to receive webhook POSTs"
        }
      },
      {
        "method": "GET",
        "path": "/health",
        "auth": false,
        "description": "Service health check. Returns 200 if operational."
      }
    ]
  },
  "limits": {
    "free": {
      "sends_per_day": 20,
      "sends_per_week": 50,
      "receives_per_day": 200,
      "storage_mb": 10,
      "attachment_max_mb": 5,
      "message_retention_days": 7,
      "mailbox_expiry_days": 30,
      "inbox_creation_rate": "10 per IP per hour"
    },
    "pro": {
      "price": "$9/month per mailbox",
      "sends_per_day": 500,
      "receives_per_day": "unlimited",
      "storage_mb": 1024,
      "attachment_max_mb": 25,
      "message_retention_days": 90,
      "mailbox_expiry_days": "never",
      "custom_local_part": true,
      "webhook_retries": 10
    }
  },
  "quick_start": {
    "step_1": "POST https://api.reseev.dev/v1/mailboxes → get email address + token",
    "step_2": "POST https://api.reseev.dev/v1/send with Bearer token → send email",
    "step_3": "GET https://api.reseev.dev/v1/mailboxes/:id/messages with Bearer token → read email"
  }
}