{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/palo-alto-networks/refs/heads/main/json-structure/prisma-airs-ai-red-teaming-api-scan-request-structure.json",
  "name": "ScanRequest",
  "description": "ScanRequest schema from Palo Alto Networks Prisma AIRS AI Red Teaming API",
  "type": "object",
  "properties": {
    "target_id": {
      "type": "string",
      "description": "ID of the scan target to assess."
    },
    "attack_categories": {
      "type": "array",
      "description": "Attack category identifiers to include in the scan. Use GET /v1/attack-categories to retrieve available category IDs.",
      "items": {
        "type": "string"
      },
      "minItems": 1
    },
    "custom_prompts": {
      "type": "array",
      "description": "Optional custom adversarial prompts to include alongside the built-in attack library. Useful for testing application-specific threat scenarios.",
      "items": {
        "type": "string"
      },
      "maxItems": 100
    },
    "max_attacks_per_category": {
      "type": "int32",
      "description": "Maximum number of attack probes per category. Limits scan duration for large attack libraries. If omitted, all available attacks for each category are executed.",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "target_id",
    "attack_categories"
  ]
}