{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aws-security-hub/json-schema/aws-security-hub-batch-update-findings-v2-request-schema.json",
  "title": "BatchUpdateFindingsV2Request",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aws-security-hub-findingsv2-api-openapi.yml#/components/schemas/BatchUpdateFindingsV2Request",
  "type": "object",
  "properties": {
    "MetadataUids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The list of finding metadata.uid to indicate findings to update. Finding metadata.uid is a globally unique identifier associated with the finding. Customers cannot use MetadataUids together with FindingIdentifiers."
    },
    "FindingIdentifiers": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/OcsfFindingIdentifier"
      },
      "description": "Provides information to identify a specific V2 finding."
    },
    "Comment": {
      "type": "string",
      "description": "The updated value for a user provided comment about the finding. Minimum character length 1. Maximum character length 512."
    },
    "SeverityId": {
      "type": "integer",
      "description": "The updated value for the normalized severity identifier. The severity ID is an integer with the allowed enum values [0, 1, 2, 3, 4, 5, 6, 99]. When customer provides the updated severity ID, the string sibling severity will automatically be updated in the finding."
    },
    "StatusId": {
      "type": "integer",
      "description": "The updated value for the normalized status identifier. The status ID is an integer with the allowed enum values [0, 1, 2, 3, 4, 5, 99]. When customer provides the updated status ID, the string sibling status will automatically be updated in the finding."
    }
  },
  "$defs": {
    "OcsfFindingIdentifier": {
      "type": "object",
      "properties": {
        "CloudAccountUid": {
          "type": "string",
          "description": "Finding cloud.account.uid, which is a unique identifier in the Amazon Web Services account.."
        },
        "FindingInfoUid": {
          "type": "string",
          "description": "Finding finding_info.uid, which is a unique identifier for the finding from the finding provider."
        },
        "MetadataProductUid": {
          "type": "string",
          "description": "Finding metadata.product.uid, which is a unique identifier for the product."
        }
      },
      "required": [
        "CloudAccountUid",
        "FindingInfoUid",
        "MetadataProductUid"
      ]
    }
  }
}