Overview

Waives a specific validation item on a proposal, allowing the workflow to proceed despite the validation failure. The validation record must exist and belong to the specified proposal.

Waiving does not remove the item from the validation list. It remains visible in subsequent calls to GET .../Validations/Status with Waived set to true, WaivedByUserID set to the current user, and WaivedReason populated with the supplied reason. To reverse a waiver, call POST .../Validations/{id}/Unwaive.

The id route parameter is the ProposalValidationID from the validation items returned by GET .../Validations/Status or GET .../Validations/{domain}/{id}.

Examples

Scenario 1: Successfully waive a validation:

POST /api/Quotes/Proposals/12345/Validations/1001/Waive?waiveReason=Approved%20by%20underwriter

200 OK
{
  "IsSuccessful": true,
  "RecordID": 1001,
  "Message": "Validation record #1001 waived."
}

Scenario 2: Validation does not belong to the proposal:

POST /api/Quotes/Proposals/99999/Validations/1001/Waive?waiveReason=Override

500 Internal Server Error
"Validation record not found in the proposal."