{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kenna-security/json-schema/kenna-security-finding-put-request-body-schema-schema.json",
  "title": "finding_put_request_body_schema",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kenna-security-findings-api-openapi.yml#/components/schemas/finding_put_request_body_schema",
  "type": "object",
  "properties": {
    "asset_id": {
      "type": "integer",
      "description": "The ID of the Asset associated with the Finding.",
      "format": "int32"
    },
    "external_unique_id": {
      "type": "string",
      "description": "A unique ID, created by a Scanner or client."
    },
    "identifier": {
      "type": "string",
      "description": "A CVE, CWE, or WASC. Example: \"CWE-242\"."
    },
    "closed_at": {
      "type": "string",
      "description": "When the Finding was closed. The status body parameter is required to have the status body parameter set to one of the valid closed status values: \"closed\", \"duplicate\", \"false_positive\", \"resolved\", and \"not_a_security_issue\". This implies that both closed_at and status will be updated.",
      "format": "date-time"
    },
    "due_date": {
      "type": "string",
      "description": "When the Finding should be fixed.",
      "format": "date-time"
    },
    "found_on": {
      "type": "string",
      "description": "When the Finding was initially found.",
      "format": "date-time"
    },
    "last_found_on": {
      "type": "string",
      "description": "When the Finding was last seen.",
      "format": "date-time"
    },
    "additional_fields": {
      "$ref": "#/$defs/additional_fields"
    },
    "remediation": {
      "type": "string",
      "description": "Instructions for remediating the Finding."
    },
    "scanner_score": {
      "type": "number",
      "description": "The score provided by the Scanner.",
      "format": "float"
    },
    "status": {
      "$ref": "#/$defs/finding_status",
      "description": "The new status of the Finding"
    }
  },
  "$defs": {
    "additional_fields": {
      "description": "Any additional information you want associated with the Finding.",
      "type": "object",
      "properties": {
        "fields": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "field_name": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "finding_status": {
      "type": "string",
      "enum": [
        "duplicate",
        "false_positive",
        "in_progress",
        "new",
        "not_a_security_issue",
        "resolved",
        "risk_accepted",
        "triaged"
      ]
    }
  }
}