post_finance_clawbacks_by_id_decide

{
  "name": "post_finance_clawbacks_by_id_decide",
  "description": "POST /api/finance/clawbacks/{id}/decide — Records Pawsitive Future's decision. An approval pauses the service provider's payouts, sends it the written notice (the amount, the claim, the reason, and how to contest within 30 days) and then executes the clawback — reverses the payout's Stripe transfer, or for PFF_DISCRETIONARY recovers by offset only — so the answer carries `noticeSentAt` and `transferReversalState`. A notice that does not send leaves the clawback APPROVED with `noticeSentAt: null` and nothing recovered; an execution that does not finish is retried by POST /api/finance/clawbacks/{id}/execute. Either way the decision stands (200). A denial of a clawback the service provider filed is emailed to it. An approval's fee liability is the one named, else the one Pawsitive Future's filing proposed, else SERVICE_PROVIDER; Pawsitive Future may absorb the fees on any clawback, and can change who pays while it is collected (PUT /api/finance/clawbacks/{id}/fee-liability). An approval also records whether the voucher stops counting as help delivered once the clawback resolves (`voucherValueReversed`): the reason's default (`voucherValueReversedByDefault`) unless named, and required for a reason with none (PFF_DISCRETIONARY, OTHER) — approving one without it is refused (400). A denial takes neither (400).\n\nThis changes data. The person is asked to confirm it before it runs, and nothing happens if they decline.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "body": {
        "type": "string",
        "description": "The JSON request body: { decision*: one of \"APPROVE\" | \"DENY\"; feeLiability: {  }; voucherValueReversed: boolean (An approval's answer; the reason's default when omitted, and required for PFF_DISCRETIO...) }"
      }
    },
    "required": [
      "id",
      "body"
    ]
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": false
  }
}