{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aws-security-hub/json-schema/aws-security-hub-get-remediations-v2-request-schema.json",
  "title": "GetRemediationsV2Request",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aws-security-hub-operations-api-openapi.yml#/components/schemas/GetRemediationsV2Request",
  "type": "object",
  "properties": {
    "TargetUid": {
      "type": "string",
      "description": "The unique identifier (ID) of an existing remediation target to return. Returns the single matching target. You can't use TargetUid together with MetadataUid or Filters."
    },
    "MetadataUid": {
      "type": "string",
      "description": "The unique identifier (ID) of the Security Hub exposure finding, found under the metadata.uid field of the finding. Returns the remediation targets associated with that finding. You can't use MetadataUid together with TargetUid or Filters."
    },
    "Filters": {
      "$ref": "#/$defs/RemediationFilters"
    },
    "ShowGuidance": {
      "type": "boolean",
      "description": "Specifies whether to show remediation target guidance."
    },
    "GuidanceFormat": {
      "type": "string",
      "enum": [
        "All",
        "AwsCli",
        "Cli",
        "Python",
        "Terraform",
        "Cdk",
        "CloudFormation",
        "IaC",
        "Template"
      ],
      "description": "The format of the remediation guidance examples to return. Valid values are All, AwsCli, Cli, Python, Terraform, Cdk, CloudFormation, IaC, and Template. If you don't specify a value, all formats are returned. Applies only when ShowGuidance is true."
    },
    "MaxResults": {
      "type": "integer",
      "description": "The maximum number of results to return. Valid range is 1-100. If you don't specify a value, the operation returns up to 25 results."
    },
    "NextToken": {
      "type": "string",
      "description": "The token used to paginate the remediations target list returned. On your first call to GetRemediationsV2, omit this parameter or set it to NULL. For subsequent calls, use the NextToken value returned in the previous response to retrieve the next page of results."
    }
  },
  "$defs": {
    "RemediationCompositeFilter": {
      "type": "object",
      "properties": {
        "StringFilters": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/RemediationStringFilter"
          },
          "description": "Enables filtering based on string field values."
        }
      }
    },
    "RemediationFilters": {
      "type": "object",
      "properties": {
        "CompositeFilters": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/RemediationCompositeFilter"
          },
          "description": "A collection of complex filtering conditions that can be applied to remediation target data."
        }
      }
    },
    "RemediationStringFilter": {
      "type": "object",
      "properties": {
        "FieldName": {
          "type": "string",
          "enum": [
            "Resource.Type",
            "Priority",
            "Status",
            "Resource.Id",
            "Resource.ResourceOwnerAccountId",
            "Resource.CloudProvider"
          ],
          "description": "The name of the filter field. Valid values are Resource.Type, Priority, Status, Resource.Id, Resource.ResourceOwnerAccountId, and Resource.CloudProvider."
        },
        "Filter": {
          "$ref": "#/$defs/RemediationStringFilterCondition"
        }
      },
      "required": [
        "FieldName",
        "Filter"
      ]
    },
    "RemediationStringFilterCondition": {
      "type": "object",
      "properties": {
        "Value": {
          "type": "string",
          "description": "The value the string filter is comparing against."
        }
      },
      "required": [
        "Value"
      ]
    }
  }
}