AWS Security Hub · Schema

BatchUpdateFindingsV2Request

SecurityCloud Security Posture ManagementComplianceFindingsThreat DetectionCloudAmazon Web Services

Properties

Name Type Description
MetadataUids array 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 Findi
FindingIdentifiers array Provides information to identify a specific V2 finding.
Comment string The updated value for a user provided comment about the finding. Minimum character length 1. Maximum character length 512.
SeverityId integer 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 stri
StatusId integer 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 siblin
View JSON Schema on GitHub

JSON Schema

aws-security-hub-batch-update-findings-v2-request-schema.json Raw ↑
{
  "$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"
      ]
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/aws-security-hub-batch-update-findings-v2-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.