RestUpdateFindingDto

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/hacktron/json-schema/hacktron-rest-update-finding-dto-schema.json",
  "title": "RestUpdateFindingDto",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/hacktron-openapi.json#/components/schemas/RestUpdateFindingDto",
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "enum": [
        "open",
        "true_positive",
        "false_positive",
        "accepted_risk",
        "resolved",
        "closed"
      ],
      "description": "New finding state"
    },
    "severity": {
      "type": "string",
      "enum": [
        "critical",
        "high",
        "medium",
        "low",
        "info"
      ],
      "description": "New severity level"
    },
    "state_reason": {
      "type": "string",
      "description": "Reason for the state change (defaults to reason if omitted)"
    },
    "severity_reason": {
      "type": "string",
      "description": "Reason for the severity change (defaults to reason if omitted)"
    },
    "reason": {
      "type": "string",
      "description": "Shorthand reason applied to both state and severity changes when their specific reason is not provided"
    },
    "duplicate_of": {
      "type": [
        "string",
        "null"
      ],
      "description": "UUID of the canonical finding to mark this finding as a duplicate of, or null to unmark. The target must be in the same repository."
    }
  }
}