magento.watch

Get detailed information about a specific Magento/Adobe Commerce version including release date, EOL date, system requirements, and a security summary: `security.fixedBy` (security fixes already included in this version) and `security.vulnerableTo` (open bulletins that still need an upgrade or an isolated patch)

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ],
      "description": "The Magento distribution"
    },
    "version": {
      "type": "string",
      "description": "Version number (e.g., \"2.4.8\", \"2.4.7-p3\")"
    }
  },
  "required": [
    "distribution",
    "version"
  ]
}

Get all versions for a distribution with their lifecycle information. Each version carries `securitySummary` { status, requiredPatches, upgradeRequired }: `isSecureVersion` and `statusLabel` describe the support lifecycle only, so a supported version can still have open bulletins. Call check_version_security for the remedies.

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ]
    }
  },
  "required": [
    "distribution"
  ]
}

Get only currently supported versions (not EOL, not future releases). Each version carries `securitySummary` { status, requiredPatches, upgradeRequired }: `isSecureVersion` and `statusLabel` describe the support lifecycle only, so a supported version can still have open bulletins. Call check_version_security for the remedies.

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ]
    }
  },
  "required": [
    "distribution"
  ]
}

Get versions that have reached end-of-life. Each version carries `securitySummary` { status, requiredPatches, upgradeRequired }: `isSecureVersion` and `statusLabel` describe the support lifecycle only, so a supported version can still have open bulletins. Call check_version_security for the remedies.

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ]
    }
  },
  "required": [
    "distribution"
  ]
}

Check if a specific PHP, MySQL, or other dependency version is compatible with a Magento version

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ]
    },
    "magentoVersion": {
      "type": "string",
      "description": "Magento version (e.g., \"2.4.8\")"
    },
    "dependency": {
      "type": "string",
      "description": "Dependency name (e.g., \"php\", \"mysql\", \"elasticsearch\", \"redis\")"
    },
    "dependencyVersion": {
      "type": "string",
      "description": "Dependency version to check (e.g., \"8.3\", \"8.0\")"
    }
  },
  "required": [
    "distribution",
    "magentoVersion",
    "dependency",
    "dependencyVersion"
  ]
}

Get the latest stable version for a distribution. Each version carries `securitySummary` { status, requiredPatches, upgradeRequired }: `isSecureVersion` and `statusLabel` describe the support lifecycle only, so a supported version can still have open bulletins. Call check_version_security for the remedies.

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ]
    }
  },
  "required": [
    "distribution"
  ]
}

List Adobe/Magento security bulletins (CVEs), optionally filtered by severity or publish date. Use this to list critical bulletins since a given date, or to survey what has been disclosed.

{
  "type": "object",
  "properties": {
    "severity": {
      "type": "string",
      "enum": [
        "critical",
        "important",
        "moderate"
      ],
      "description": "Only return bulletins of this severity"
    },
    "since": {
      "type": "string",
      "format": "date",
      "description": "Only return bulletins published on or after this date (YYYY-MM-DD)"
    }
  }
}

Get one security bulletin by id, including a plain-text summary, its CVEs, severity, and which versions per distribution contain the fix. Use this when the user names a specific bulletin or asks which patch fixes a given CVE.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Bulletin id (e.g., \"APSB24-40\")"
    }
  },
  "required": [
    "id"
  ]
}

Check whether a specific Magento/Adobe Commerce version is vulnerable to known security bulletins, and which version fixes it. A version is also vulnerable when the only remedy from Adobe is an isolated patch applied on top of that base release; fixedIn is then null. This is the tool to call when a user asks "is my Magento vulnerable" or "which patch fixes CVE-...".

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ]
    },
    "version": {
      "type": "string",
      "description": "Version number (e.g., \"2.4.7\", \"2.4.7-p3\")"
    }
  },
  "required": [
    "distribution",
    "version"
  ]
}

Find Adobe Quality Patches Tool (QPT) patches for a Magento Open Source or Adobe Commerce version. With only distribution and version it lists every applicable patch. Add query (symptoms, error text, feature words or a patch id like ACSD-56760), modules (e.g. "catalog", "module-sales") or categories (QPT names like "Admin", "Catalog/Product") to get a ranked list with a 0-100 relevance score and the signals that matched. Covers quality patches only; for security fixes use check_version_security. List mode can return several hundred hits; pass query, modules or categories to rank and limit. Mage-OS is not a QPT target and always returns status "unknown".

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ]
    },
    "version": {
      "type": "string",
      "description": "Exact Magento version, e.g. \"2.4.7-p3\""
    },
    "query": {
      "type": "string",
      "description": "Free text: symptoms, error message, feature names, or a patch id"
    },
    "modules": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Module names with or without the magento/module- prefix"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "QPT category names"
    },
    "includeInapplicable": {
      "type": "boolean",
      "description": "Also rank patches that do not apply to this version; each hit keeps its real applicable flag"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Ranked mode only, default 10"
    }
  },
  "required": [
    "distribution",
    "version"
  ]
}

Get one Quality Patches Tool patch by id (e.g. "ACSD-56760") with every file variant, its Composer constraint, resolved applicable versions per distribution, modified files, prerequisites, documentation fields and the raw patch URL.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Patch id, e.g. \"ACSD-56760\""
    },
    "version": {
      "type": "string",
      "description": "Optional version: includes install instructions and a bundle URL for all applicable non-deprecated files, or composer null when none apply. Without a version, returns the bare entry."
    },
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce"
      ],
      "description": "Optional distribution for installation. Defaults to magento-commerce when a live Commerce file applies to the version, otherwise magento-community."
    }
  },
  "required": [
    "id"
  ]
}

Community fixes merged into magento/magento2 after a release line was cut, with per-version applicability from git apply checks; not Adobe Quality Patches, for those use find_patch. With only distribution and version it lists, newest first, every upstream fix whose code applies cleanly to that version and that the version does not contain yet. Add query (symptoms, error text, feature words or an id like magento2-40867), modules or categories (QPT category names like "GraphQL", "Catalog/Product") to get a ranked list with a 0-100 relevance score and the signals that matched. fixedIn filters by the first release that contains the fix (null for fixes not in any release yet). Mage-OS always returns status "unknown"; a version outside the checked release tags returns status "unknown-version".

{
  "type": "object",
  "properties": {
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce",
        "mage-os"
      ]
    },
    "version": {
      "type": "string",
      "description": "Exact Magento version, e.g. \"2.4.8-p3\""
    },
    "query": {
      "type": "string",
      "description": "Free text: symptoms, error message, feature names, or an upstream fix id"
    },
    "modules": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Module names with or without the magento/module- prefix"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "QPT category names"
    },
    "fixedIn": {
      "type": [
        "string",
        "null"
      ],
      "description": "Only fixes first released in this version, e.g. \"2.4.9\"; null for fixes not in any release yet"
    },
    "includeExcluded": {
      "type": "boolean",
      "description": "Also return entries excluded as features, refactors or test-only changes; each hit keeps its excluded reason"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Ranked mode only, default 10"
    }
  },
  "required": [
    "distribution",
    "version"
  ]
}

Community fixes merged into magento/magento2 after a release line was cut, with per-version applicability from git apply checks; not Adobe Quality Patches, for those use find_patch. Get one upstream fix by id (e.g. "magento2-40867") with its pull request, linked issues, first release containing it, per-tag code match, affected versions, touched packages and files, labels and triage scores. Pass version, and optionally distribution, to get the code match for that version and the Composer bundle URL when the fix applies to it.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Upstream fix id, e.g. \"magento2-40867\""
    },
    "version": {
      "type": "string",
      "description": "Optional version: adds the code match for that version and the Composer bundle URL, or install null when the fix does not apply to it"
    },
    "distribution": {
      "type": "string",
      "enum": [
        "magento-community",
        "magento-commerce"
      ],
      "description": "Optional distribution for installation, default magento-community"
    }
  },
  "required": [
    "id"
  ]
}