{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/pageweave-dev/json-schema/pageweave-dev-feedback-recipient-schema.json",
  "title": "FeedbackRecipient",
  "x-generated": "2026-11-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/pageweave-dev-openapi.json#/components/schemas/FeedbackRecipient",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "website_id",
    "email",
    "email_masked",
    "status",
    "reason",
    "deliverable",
    "digest_open",
    "next_digest_at",
    "last_digested_at",
    "confirmed_at",
    "confirmation_sent_at",
    "confirmation_expires_at",
    "created_at",
    "updated_at"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "website_id": {
      "type": "string",
      "format": "uuid"
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "format": "email",
      "description": "Null unless the caller has feedback.recipient.manage."
    },
    "email_masked": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "active",
        "unsubscribed",
        "suppressed"
      ]
    },
    "reason": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "recipient_unsubscribed",
        "recipient_declined",
        "owner_removed",
        "hard_bounce",
        "unsubscribed",
        null
      ]
    },
    "deliverable": {
      "type": "boolean"
    },
    "digest_open": {
      "type": "boolean",
      "description": "Whether this address sits in a live digest window. Only deliverable recipients do."
    },
    "next_digest_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "The debounced flush point; null while no window is open or the row is not deliverable."
    },
    "last_digested_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Watermark — the last digest mail this address received; advances only after the provider accepted the send."
    },
    "confirmed_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "confirmation_sent_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "confirmation_expires_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}