{
  "emailId": "eml_welcome",
  "status": "partial",
  "previews": [
    {
      "id": "gmailcom-lm_chrcurrent_win10",
      "label": "Gmail (Web)",
      "category": "gmail",
      "os": "Web",
      "dark": false,
      "status": "ready",
      "imageUrl": "https://cdn.brew.new/email-preview/eml_welcome/gmailcom-lm_chrcurrent_win10-abc.png"
    },
    {
      "id": "outlook2021_win11_lm_dt",
      "label": "Outlook 2021 (Windows)",
      "category": "outlook",
      "os": "Windows",
      "dark": false,
      "status": "processing",
      "imageUrl": null
    }
  ],
  "pending": [
    "outlook2021_win11_lm_dt"
  ]
}

{
  "error": {
    "code": "INVALID_API_KEY",
    "type": "authentication_error",
    "message": "The provided API key is invalid.",
    "suggestion": "Check the API key format and retry with a valid active key.",
    "docs": "https://docs.brew.new/api-reference/api/authentication"
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "type": "payment_required",
    "message": "This operation required more credits than the 0 remaining on the 'free' plan. See the per-operation cost in GET /v1/help.",
    "suggestion": "Upgrade your plan or wait for the next billing period to reset. Check your balance up front with GET /v1/usage.",
    "docs": "https://docs.brew.new/api-reference/api/credits",
    "details": {
      "cost": 2,
      "remaining": 0,
      "planKey": "free"
    }
  }
}

{
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "type": "authorization_error",
    "message": "The caller does not have the required permission.",
    "suggestion": "Use an API key or session with the required permission.",
    "docs": "https://docs.brew.new/api-reference/api/authentication",
    "param": "emails"
  }
}

{
  "error": {
    "code": "EMAIL_NOT_FOUND",
    "type": "not_found",
    "message": "No email exists with id 'eml_welcome'.",
    "suggestion": "Verify the emailId via GET /v1/emails.",
    "docs": "https://docs.brew.new/api-reference/api/errors"
  }
}

{
  "error": {
    "code": "IDEMPOTENCY_CONFLICT",
    "type": "conflict",
    "message": "The same idempotency key was reused with a different request payload.",
    "suggestion": "Reuse the original payload or send a new idempotency key.",
    "docs": "https://docs.brew.new/api-reference/api/idempotency"
  }
}

{
  "error": {
    "code": "CONTENT_OPERATION_FAILED",
    "type": "invalid_request",
    "message": "The client-preview operation could not be completed: the email has no rendered HTML yet (it may still be generating).",
    "suggestion": "Poll GET /v1/emails?emailId= until status is complete, then retry.",
    "docs": "https://docs.brew.new/api-reference/api/errors"
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "type": "rate_limit",
    "message": "Too many requests.",
    "suggestion": "Wait for the retry window before sending another request.",
    "docs": "https://docs.brew.new/api-reference/api/rate-limits",
    "retryAfter": 42
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "type": "internal_error",
    "message": "An unexpected error occurred.",
    "suggestion": "Retry the request. If it keeps failing, contact support.",
    "docs": "https://docs.brew.new/api-reference/api/errors"
  }
}

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "type": "service_unavailable",
    "message": "The email preview is still rendering — no client finished within the time limit.",
    "suggestion": "Retry in a few seconds. You are not charged when no preview is produced.",
    "docs": "https://docs.brew.new/api-reference/api/errors"
  }
}