{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/coveragecat-com/json-schema/coveragecat-com-intake-assistant-patch-request-schema.json",
  "title": "IntakeAssistantPatchRequest",
  "description": "Partial intake patch for the first-party assistant follow-up API. Send user-confirmed edits directly as top-level intake fields. For homeowners after submission, this same patch call can also send `message_reply` to answer insurer or shopper follow-up already surfaced under `conversation.messages`, and `reply_to_message_id` pins the reply to one returned conversation message when Coverage Cat marks `conversation.reply_pending`. For umbrella intakes, top-level field_estimates[] rows may accompany inferred values when you are certain each field path matches a current umbrella review field. Use canonical umbrella count corrections such as `umbrella_details.motorized_vehicle_count` and never send `vehicles` rows on this pre-submit patch. `current_auto_coverages` is a banded enum, not free text: send one of `unsure` for I'm not sure; `500k/1m` for $500k/$1 Million/$100k or higher; `500k/500k` for $500k/$500k/$100k or $500k CSL; `300k/300k` for $250k/$500k/$100k or $300k/$300k/$100k or $300k CSL; `100k/300k` for $100k/$300k/$100k or lower. Coverage Cat rejects the shopper's raw limits, so translate them into the strongest band those limits fully satisfy. Underlying auto limits gate umbrella eligibility, so reserve `unsure` for limits the shopper genuinely does not know rather than using it to skip the translation. Normalize shopper birthdays from MM-DD-YYYY to YYYY-MM-DD before sending them. Set confirm_submission: true on the final one-time review turn to submit and start quote generation.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/coveragecat-com-agent-openapi.yml#/components/schemas/IntakeAssistantPatchRequest",
  "additionalProperties": true,
  "properties": {
    "confirm_submission": {
      "description": "Set to true on the single human review turn once the user has reviewed the application and wants Coverage Cat to submit now. Homeowners also require a versioned credit_consent receipt on that same final turn; umbrella consumer-report authorization for insurance underwriting is collected later at select.",
      "type": "boolean"
    },
    "contact_preferences": {
      "additionalProperties": false,
      "description": "Optional service SMS/call choices. Offer alongside an existing review when useful; do not add a required purchase step. Omission leaves choices unchanged. Marketing is disabled.",
      "properties": {
        "service_call": {
          "additionalProperties": false,
          "description": "Optional service contact choice for the phone number already on file; never a purchase requirement or marketing authorization.",
          "properties": {
            "answer": {
              "description": "The customer's own Yes, No or Revoke answer to the corresponding service disclosure.",
              "enum": [
                "Yes",
                "No",
                "Revoke"
              ],
              "type": "string"
            },
            "collected_from_user": {
              "const": true,
              "description": "The customer personally answered this service contact question.",
              "type": "boolean"
            },
            "disclosure_hash": {
              "description": "text_hash from the corresponding contact_preferences_disclosures entry.",
              "type": "string"
            },
            "disclosure_version": {
              "description": "Version from the corresponding contact_preferences_disclosures entry.",
              "type": "string"
            },
            "presentation_reference": {
              "description": "Optional opaque conversation or message reference; do not include message contents or personal information.",
              "maxLength": 200,
              "type": "string"
            },
            "presented_at": {
              "description": "RFC 3339 timestamp from the assistant runtime for when the complete disclosure was shown. It must be within the prior 24 hours and no more than five minutes in the future.",
              "format": "date-time",
              "type": "string"
            },
            "shown_to_user": {
              "const": true,
              "description": "Attests that the complete returned disclosure text was presented verbatim before the shopper answered.",
              "type": "boolean"
            }
          },
          "required": [
            "answer",
            "collected_from_user",
            "shown_to_user",
            "disclosure_version",
            "disclosure_hash",
            "presented_at"
          ],
          "type": "object"
        },
        "service_sms": {
          "additionalProperties": false,
          "description": "Optional service contact choice for the phone number already on file; never a purchase requirement or marketing authorization.",
          "properties": {
            "answer": {
              "description": "The customer's own Yes, No or Revoke answer to the corresponding service disclosure.",
              "enum": [
                "Yes",
                "No",
                "Revoke"
              ],
              "type": "string"
            },
            "collected_from_user": {
              "const": true,
              "description": "The customer personally answered this service contact question.",
              "type": "boolean"
            },
            "disclosure_hash": {
              "description": "text_hash from the corresponding contact_preferences_disclosures entry.",
              "type": "string"
            },
            "disclosure_version": {
              "description": "Version from the corresponding contact_preferences_disclosures entry.",
              "type": "string"
            },
            "presentation_reference": {
              "description": "Optional opaque conversation or message reference; do not include message contents or personal information.",
              "maxLength": 200,
              "type": "string"
            },
            "presented_at": {
              "description": "RFC 3339 timestamp from the assistant runtime for when the complete disclosure was shown. It must be within the prior 24 hours and no more than five minutes in the future.",
              "format": "date-time",
              "type": "string"
            },
            "shown_to_user": {
              "const": true,
              "description": "Attests that the complete returned disclosure text was presented verbatim before the shopper answered.",
              "type": "boolean"
            }
          },
          "required": [
            "answer",
            "collected_from_user",
            "shown_to_user",
            "disclosure_version",
            "disclosure_hash",
            "presented_at"
          ],
          "type": "object"
        }
      },
      "type": "object"
    },
    "credit_consent": {
      "additionalProperties": false,
      "description": "The real user's response to Coverage Cat's current consumer-report authorization for insurance underwriting, collected only after Coverage Cat returns the disclosure.",
      "properties": {
        "answer": {
          "description": "Records the shopper's own Yes, No or Revoke reply. Preserve declines and revocations; never infer or convert another answer into Yes.",
          "enum": [
            "Yes",
            "No",
            "Revoke"
          ],
          "type": "string"
        },
        "collected_from_user": {
          "const": true,
          "description": "Attests that the shopper personally answered the displayed authorization in this conversation, rather than the agent assuming their response.",
          "type": "boolean"
        },
        "disclosure_hash": {
          "description": "The text_hash from credit_consent_disclosure.",
          "type": "string"
        },
        "disclosure_version": {
          "description": "The version from credit_consent_disclosure.",
          "type": "string"
        },
        "presentation_reference": {
          "description": "Optional opaque conversation or message reference; do not include message contents or personal information.",
          "maxLength": 200,
          "type": "string"
        },
        "presented_at": {
          "description": "RFC 3339 timestamp from the assistant runtime for when the complete disclosure was shown. It must be within the prior 24 hours and no more than five minutes in the future.",
          "format": "date-time",
          "type": "string"
        },
        "shown_to_user": {
          "const": true,
          "description": "Attests that the complete returned disclosure text was presented verbatim before the shopper answered.",
          "type": "boolean"
        }
      },
      "required": [
        "answer",
        "collected_from_user",
        "shown_to_user",
        "disclosure_version",
        "disclosure_hash",
        "presented_at"
      ],
      "type": "object"
    },
    "current_auto_coverages": {
      "description": "Which band the shopper's current underlying auto liability limits fall into: `500k/1m` covers $500k/$1 Million/$100k or higher; `500k/500k` covers $500k/$500k/$100k or $500k CSL; `300k/300k` covers $250k/$500k/$100k or $300k/$300k/$100k or $300k CSL; `100k/300k` covers $100k/$300k/$100k or lower. Pick the strongest band the shopper's actual limits fully satisfy. Underlying auto limits gate umbrella eligibility, so use `unsure` only when the shopper genuinely does not know their limits.",
      "enum": [
        "unsure",
        "500k/1m",
        "500k/500k",
        "300k/300k",
        "100k/300k"
      ],
      "type": "string"
    },
    "field_estimates": {
      "description": "Umbrella-only estimate metadata for inferred values included in the same patch. Omit it unless you are certain each field path matches a current umbrella review field. Homeowners estimate provenance stays under intake.home[].field_estimates[].",
      "items": {
        "$ref": "#/$defs/UmbrellaFieldEstimateInput"
      },
      "type": "array"
    },
    "message_reply": {
      "description": "Homeowners post-submit only. Send the reply text Coverage Cat should deliver in-thread when the latest issues payload shows `conversation.reply_pending`, such as answering a carrier underwriting question.",
      "type": "string"
    },
    "reply_to_message_id": {
      "description": "Optional homeowners post-submit target from `conversation.messages[].message_id`. Use it when Coverage Cat returned a specific follow-up message to answer in-thread.",
      "type": "integer"
    }
  },
  "type": "object",
  "$defs": {
    "UmbrellaFieldEstimateInput": {
      "additionalProperties": false,
      "description": "Metadata for one umbrella answer in the draft request whose current value is not directly user-confirmed yet. The actual value still comes from the `intake` patch at the same field path.\n",
      "properties": {
        "confidence": {
          "enum": [
            "low",
            "medium",
            "high"
          ],
          "type": "string"
        },
        "field": {
          "description": "Intake dot-path for the inferred answer, such as `marital_status`, `address.zip`, or `additional_drivers.0.license_state`.\n",
          "type": "string"
        },
        "source": {
          "description": "Opaque operator-side provenance label such as `crm`, `email_thread`, `policy_declarations`, or `historical_mode`.\n",
          "type": "string"
        }
      },
      "required": [
        "field",
        "source",
        "confidence"
      ],
      "type": "object"
    }
  }
}