Updated
Jul 8, 2024, 8:38:31 PM

{
    "$id": "https://vulnerability.circl.lu/static/schemas/CIRCL/Security_Advisory_Bundle.json",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "additionalProperties": false,
    "description": "This schema specifies the format of a bundle related to several security advisories.",
    "properties": {
        "creation_timestamp": {
            "description": "When the bundle was created originally.",
            "format": "datetime-local",
            "options": {
                "hidden": true
            },
            "type": "string"
        },
        "description": {
            "format": "markdown",
            "title": "Description of the bundle",
            "type": "string"
        },
        "description_format": {
            "default": "markdown",
            "description": "Format of the bundle (markdown or text).",
            "enum": [
                "markdown",
                "text"
            ],
            "type": "string"
        },
        "meta": {
            "description": "Zero or more meta-fields",
            "items": {
                "description": "Meta fields",
                "type": "object"
            },
            "type": "array"
        },
        "name": {
            "maxLength": 65535,
            "title": "Name of the bundle.",
            "type": "string"
        },
        "related_vulnerabilities": {
            "description": "One or more vulnerability references for this bundle.",
            "items": {
                "description": "Vulnerability reference (CVE ID, GHSA-ID, PYSEC ID, etc.).",
                "minLength": 1,
                "type": "string"
            },
            "minItems": 1,
            "title": "Related vulnerabilities",
            "type": "array"
        },
        "timestamp": {
            "description": "When the bundle was last updated.",
            "format": "datetime-local",
            "options": {
                "hidden": true
            },
            "type": "string"
        },
        "uuid": {
            "description": "UUIDv4 of the bundle.",
            "format": "uuid",
            "options": {
                "hidden": true
            },
            "readOnly": true,
            "type": "string"
        },
        "vulnerability_lookup_origin": {
            "default": "1a89b78e-f703-45f3-bb86-59eb712668bd",
            "description": "UUIDv4 of the vulnerability lookup instance.",
            "options": {
                "hidden": true
            },
            "pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}",
            "readOnly": true,
            "type": "string"
        }
    },
    "required": [
        "uuid",
        "vulnerability_lookup_origin",
        "creation_timestamp",
        "timestamp",
        "name",
        "description",
        "related_vulnerabilities"
    ],
    "title": "Security Advisory bundle format.",
    "type": "object"
}