changedOutput schema / oneOf
Previous value: -[
- {
- "additionalProperties": {},
- "properties": {
- "coverage": {
- "anyOf": [
- {
- "additionalProperties": {},
- "properties": {
- "vendor_window": {
- "anyOf": [
- {
- "additionalProperties": {},
- "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
- "properties": {
- "advisories": {
- "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
- "type": [
- "number",
- "null"
- ]
- },
- "earliest_vendor_published_at": {
- "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
- "type": [
- "string",
- "null"
- ]
- },
- "feed_held_since": {
- "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
- "type": [
- "string",
- "null"
- ]
- },
- "held_since": {
- "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
- "type": [
- "string",
- "null"
- ]
- },
- "history_backfill": {
- "anyOf": [
- {
- "anyOf": [
- {
- "enum": [
- "complete",
- "complete_reviewed_only",
- "in_progress",
- "not_started",
- "not_supported"
- ],
- "type": "string"
- },
- {
- "type": "string"
- }
- ]
- },
- {
- "type": "null"
- }
- ],
- "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
- },
- "history_scope": {
- "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
- "type": [
- "string",
- "null"
- ]
- },
- "latest_vendor_published_at": {
- "description": "The latest vendor_published_at among them; null when none is held.",
- "type": [
- "string",
- "null"
- ]
- },
- "vendor": {
- "description": "The vendor slug.",
- "type": "string"
- },
- "vendor_display_name": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "vendor",
- "vendor_display_name",
- "advisories",
- "earliest_vendor_published_at",
- "latest_vendor_published_at",
- "held_since",
- "feed_held_since",
- "history_backfill",
- "history_scope"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
- }
- },
- "required": [
- "vendor_window"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "What the answer covers; null where the answer says nothing about it."
- },
- "data": {
- "additionalProperties": {},
- "properties": {
- "advisory_id": {
- "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
- "type": [
- "string",
- "null"
- ]
- },
- "affected_products": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ]
- },
- "cve_ids": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ]
- },
- "cvss_v3_score": {
- "type": [
- "number",
- "null"
- ]
- },
- "description": {
- "type": [
- "string",
- "null"
- ]
- },
- "known_cve_ids": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
- },
- "our_first_seen_at": {
- "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
- "type": [
- "string",
- "null"
- ]
- },
- "references": {},
- "rejected_cve_ids": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
- },
- "remediation": {
- "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
- "type": [
- "string",
- "null"
- ]
- },
- "remediation_items_not_stored": {
- "description": "Items past the 64 stored per advisory.",
- "type": [
- "number",
- "null"
- ]
- },
- "remediation_kinds": {
- "anyOf": [
- {
- "items": {
- "anyOf": [
- {
- "enum": [
- "vendor_fix",
- "workaround",
- "mitigation",
- "no_fix_planned",
- "none_available",
- "other"
- ],
- "type": "string"
- },
- {
- "type": "string"
- }
- ]
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category, never read from the text: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. [] with remediation_state not_parsed is not a finding that it lists none."
- },
- "remediation_state": {
- "anyOf": [
- {
- "anyOf": [
- {
- "enum": [
- "parsed",
- "none_in_source",
- "not_parsed",
- "withdrawn"
- ],
- "type": "string"
- },
- {
- "type": "string"
- }
- ]
- },
- {
- "type": "null"
- }
- ],
- "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
- },
- "remediations": {
- "anyOf": [
- {
- "items": {
- "additionalProperties": {},
- "properties": {
- "cve_ids": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "description": "The CVEs the item covers; [] for the whole advisory."
- },
- "fixed_build": {
- "type": [
- "string",
- "null"
- ]
- },
- "kind": {
- "anyOf": [
- {
- "anyOf": [
- {
- "enum": [
- "vendor_fix",
- "workaround",
- "mitigation",
- "no_fix_planned",
- "none_available",
- "other"
- ],
- "type": "string"
- },
- {
- "type": "string"
- }
- ]
- },
- {
- "type": "null"
- }
- ]
- },
- "product_count": {
- "type": [
- "number",
- "null"
- ]
- },
- "product_ids": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ]
- },
- "source_category": {
- "description": "The vendor's own name for the category.",
- "type": [
- "string",
- "null"
- ]
- },
- "source_subcategory": {
- "type": [
- "string",
- "null"
- ]
- },
- "text": {
- "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars).",
- "type": [
- "string",
- "null"
- ]
- },
- "text_chars": {
- "type": [
- "number",
- "null"
- ]
- },
- "text_truncated": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "url": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "description": "Each remediation the vendor lists, with its kind, the vendor's own category."
- },
- "severity": {
- "type": [
- "string",
- "null"
- ]
- },
- "summary": {
- "type": [
- "string",
- "null"
- ]
- },
- "title": {
- "type": [
- "string",
- "null"
- ]
- },
- "vendor": {
- "type": [
- "string",
- "null"
- ]
- },
- "vendor_advisory_id": {
- "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
- "type": [
- "string",
- "null"
- ]
- },
- "vendor_display_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "vendor_modified_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "vendor_published_at": {
- "description": "The date the vendor gives for the advisory.",
- "type": [
- "string",
- "null"
- ]
- },
- "withdrawn": {
- "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "withdrawn_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "withdrawn_reason": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "data_truncated": {
- "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
- "type": "boolean"
- },
- "freshness": {
- "anyOf": [
- {
- "additionalProperties": {},
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "The producing radar's last completed check (last_run_at), where the API serves one."
- },
- "measured_at": {
- "anyOf": [
- {
- "description": "An RFC 3339 instant.",
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
- },
- "method": {
- "description": "How the numbers were produced.",
- "type": "string"
- },
- "notes": {
- "description": "Caveats, one sentence each.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "state": {
- "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
- "enum": [
- "measured",
- "not_assessed"
- ],
- "type": "string"
- },
- "truncated": {
- "additionalProperties": {
- "additionalProperties": {},
- "properties": {
- "returned": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "thinned": {
- "const": true,
- "type": "boolean"
- },
- "total": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "total",
- "returned"
- ],
- "type": "object"
- },
- "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- }
- },
- "required": [
- "state",
- "measured_at",
- "method",
- "coverage",
- "freshness",
- "notes",
- "data_truncated",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "coverage": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "vendor_window": {
- "anyOf": [
- {
- "additionalProperties": false,
- "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried) and history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say).",
- "properties": {
- "advisories": {
- "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
- "type": [
- "number",
- "null"
- ]
- },
- "earliest_vendor_published_at": {
- "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
- "type": [
- "string",
- "null"
- ]
- },
- "feed_held_since": {
- "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
- "type": [
- "string",
- "null"
- ]
- },
- "held_since": {
- "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
- "type": [
- "string",
- "null"
- ]
- },
- "history_backfill": {
- "anyOf": [
- {
- "anyOf": [
- {
- "enum": [
- "complete",
- "complete_reviewed_only",
- "in_progress",
- "not_started",
- "not_supported"
- ],
- "type": "string"
- },
- {
- "type": "string"
- }
- ]
- },
- {
- "type": "null"
- }
- ],
- "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
- },
- "history_scope": {
- "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
- "type": [
- "string",
- "null"
- ]
- },
- "latest_vendor_published_at": {
- "description": "The latest vendor_published_at among them; null when none is held.",
- "type": [
- "string",
- "null"
- ]
- },
- "vendor": {
- "description": "The vendor slug.",
- "type": "string"
- },
- "vendor_display_name": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "vendor",
- "vendor_display_name",
- "advisories",
- "earliest_vendor_published_at",
- "latest_vendor_published_at",
- "held_since",
- "feed_held_since",
- "history_backfill",
- "history_scope"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
- }
- },
- "required": [
- "vendor_window"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "error": {
- "additionalProperties": false,
- "properties": {
- "kind": {
- "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
- "enum": [
- "network",
- "timeout",
- "http",
- "not_json",
- "not_object",
- "invalid_input",
- "internal",
- "unexpected_shape",
- "radars"
- ],
- "type": "string"
- },
- "message": {
- "description": "The cause: the API's own message, or what went wrong.",
- "type": "string"
- },
- "path": {
- "description": "The API path requested, when a request was made.",
- "type": [
- "string",
- "null"
- ]
- },
- "status": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "The HTTP status, when the API answered one; 503 with kind internal and path null where this server was too busy to make the call."
- }
- },
- "required": [
- "kind",
- "path",
- "status",
- "message"
- ],
- "type": "object"
- },
- "freshness": {
- "type": "null"
- },
- "measured_at": {
- "type": "null"
- },
- "method": {
- "type": "null"
- },
- "notes": {
- "description": "Caveats, one sentence each.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "state": {
- "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
- "enum": [
- "failed",
- "invalid_input"
- ],
- "type": "string"
- }
- },
- "required": [
- "state",
- "measured_at",
- "method",
- "coverage",
- "freshness",
- "notes",
- "error"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": {},
+ "properties": {
+ "coverage": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "properties": {
+ "vendor_window": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried), history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say), and last_success_at (the vendor's last successful poll), collection_state (whether the vendor is being collected now, by EchelonGraph's feed-state rule: ok; partial, its polls succeed but held_back of the documents it lists could not be used, the oldest since held_back_since, and those advisories, or those revisions, may not be held while the rest of its feed is; failing, it is not being collected, and what it published after failing_since, its last successful poll, may not be held, whatever the window says; disabled, this deployment runs no collector for it (its held advisories are still served), so its window ends at last_success_at; a value the API adds later as it sends it, never read as ok), failing_since, held_back and held_back_since (each null when the API does not say).",
+ "properties": {
+ "advisories": {
+ "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "collection_state": {
+ "description": "Whether this vendor is being collected now, by EchelonGraph's feed-state rule: ok, partial, failing or disabled. ok: it is being collected. partial: its polls succeed, but held_back of the documents it lists could not be used, the oldest since held_back_since; those advisories, or those revisions, may not be held, and the rest of its feed is. failing: it is not being collected, and an advisory it published after failing_since, its last successful poll, may not be held, whatever the window says. disabled: this deployment runs no collector for it (its held advisories are still served), so its window ends at last_success_at, and an advisory it published after that may not be held. A value the API adds later is relayed as sent and is not read as ok. null when the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "earliest_vendor_published_at": {
+ "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "failing_since": {
+ "description": "While collection_state is failing, this vendor's last successful poll: an advisory it published after it may not be held, whatever the window says. null when it is not failing, when no successful poll is on record, or when the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "feed_held_since": {
+ "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "held_back": {
+ "description": "How many of the documents this vendor lists EchelonGraph could not use (collection_state partial): those advisories, or those revisions, may not be held. 0 when none is held back; null when the API does not say.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "held_back_since": {
+ "description": "When the oldest held-back document first failed; null when none is held back or the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "held_since": {
+ "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "history_backfill": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "enum": [
+ "complete",
+ "complete_reviewed_only",
+ "in_progress",
+ "not_started",
+ "not_supported"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
+ },
+ "history_scope": {
+ "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_success_at": {
+ "description": "This vendor's last successful poll; null when none is on record or the API does not say. While collection_state is disabled, the window ends here.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "latest_vendor_published_at": {
+ "description": "The latest vendor_published_at among them; null when none is held.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vendor": {
+ "description": "The vendor slug.",
+ "type": "string"
+ },
+ "vendor_display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "vendor",
+ "vendor_display_name",
+ "advisories",
+ "earliest_vendor_published_at",
+ "latest_vendor_published_at",
+ "held_since",
+ "feed_held_since",
+ "history_backfill",
+ "history_scope",
+ "last_success_at",
+ "collection_state",
+ "failing_since",
+ "held_back",
+ "held_back_since"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
+ }
+ },
+ "required": [
+ "vendor_window"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "What the answer covers; null where the answer says nothing about it."
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "advisory_id": {
+ "description": "EchelonGraph's internal ID for this advisory, a UUID. It is not the vendor's advisory ID (vendor_advisory_id), and an advisory's detail is not looked up by it: the detail is keyed on vendor and vendor_advisory_id.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "affected_products": {
+ "anyOf": [
+ {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "content_changed_at": {
+ "description": "When what EchelonGraph's page of this advisory shows changed with no change to the advisory: when the vendor-text rule began serving; empty when none is recorded.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cve_ids": {
+ "anyOf": [
+ {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "cve_records": {
+ "anyOf": [
+ {
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "cna": {
+ "description": "The CVE Numbering Authority that assigned the CVE and wrote its record, by its name in the CVE Program's CNA list, else its short name (e.g. Microsoft Corporation, kernel.org); null when none is on record.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cve_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cve_record_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "description": "The CVE record's description, as its CVE Numbering Authority (cna) published it in the CVE record at cve_record_url; null when there is none to serve, or when description_withheld_reason says why it is withheld.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description_withheld_reason": {
+ "description": "Why a description the CVE record has is null: matches_vendor_title: it repeats the advisory's own title, and a server-side switch for such descriptions, off by default, withheld it; null otherwise.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "echelongraph_score": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "echelongraph_severity": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fix_status": {
+ "description": "The fix status by the CVE feed's rule (state, basis, unread_inputs and the rule's evidence); null for a rejected record."
+ },
+ "kev_added_date": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "kev_listed": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "known": {
+ "description": "Whether EchelonGraph holds a CVE record for it; false: EchelonGraph holds no CVE record for it; only cve_id and cve_record_url are set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "score_assessed": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "score_confidence": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "score_unassessed_reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vuln_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "When vendor_text_withheld is true: EchelonGraph's facts of the first cve_records_cap CVEs the advisory names, in its order: the CVE record's own description, as the CVE Numbering Authority that assigned the CVE (cna) published it in the CVE record at cve_record_url, reused under the CVE Program's Terms of Use (https://www.cve.org/Legal/TermsOfUse; © The MITRE Corporation; for a CVE the vendor assigned, the vendor wrote it; null where the record has none, was rejected or is still the stub a GitHub advisory seeded, where EchelonGraph holds no record (known false), or where description_withheld_reason says it is withheld), EchelonGraph's score as the CVE feed serves it (null unless score_assessed), the CISA KEV listing, and the fix status by the CVE feed's rule. null when the vendor's text is served, or when the facts could not be read."
+ },
+ "cve_records_cap": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cve_records_total": {
+ "description": "How many CVE IDs the advisory names; cve_records holds the first cve_records_cap of them.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cvss_v3_score": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cvss_v3_vector": {
+ "description": "The CVSS v3 vector of cvss_v3_score where the vendor's source carries one (Microsoft's); null otherwise. On by-cve rows and the detail.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "known_cve_ids": {
+ "anyOf": [
+ {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."
+ },
+ "our_first_seen_at": {
+ "description": "When EchelonGraph first recorded the advisory; not the vendor's date.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "references": {},
+ "rejected_cve_ids": {
+ "anyOf": [
+ {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The CVE IDs this advisory names whose CVE record was rejected (withdrawn) by its numbering authority: each is a rejected record, not an active vulnerability, whatever the advisory's text says. The vendor's withdrawn is separate and unchanged by it. [] when none is; null when that could not be checked."
+ },
+ "remediation": {
+ "description": "The vendor's remediation as one text (the legacy field), beside remediations.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remediation_items_not_stored": {
+ "description": "Items past the 64 stored per advisory.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "remediation_kinds": {
+ "anyOf": [
+ {
+ "items": {
+ "anyOf": [
+ {
+ "enum": [
+ "vendor_fix",
+ "workaround",
+ "mitigation",
+ "no_fix_planned",
+ "none_available",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The kinds of remediation the advisory lists (for the CVE asked about, on a by-cve row), each the vendor's own category (vendor_fix, workaround, mitigation, no_fix_planned, none_available or other), or may be no_fix_planned where a Cisco advisory's summary says no fix will be released. [] with remediation_state not_parsed is not a finding that it lists none."
+ },
+ "remediation_state": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "enum": [
+ "parsed",
+ "none_in_source",
+ "not_parsed",
+ "withdrawn"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "parsed; none_in_source (EchelonGraph read the vendor's remediation, and it lists none for this CVE, which is not a finding that no fix exists); not_parsed (EchelonGraph does not read this vendor's remediation, or has not yet read this advisory: not a finding of none); withdrawn (the vendor rescinded the advisory)."
+ },
+ "remediations": {
+ "anyOf": [
+ {
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "cve_ids": {
+ "anyOf": [
+ {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The CVEs the item covers; [] for the whole advisory."
+ },
+ "fixed_build": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "kb_article": {
+ "description": "The KB article the item's url names, e.g. KB5055519, when vendor_text_withheld is true; absent otherwise.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "kind": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "enum": [
+ "vendor_fix",
+ "workaround",
+ "mitigation",
+ "no_fix_planned",
+ "none_available",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The vendor's own category: vendor_fix, workaround, mitigation, no_fix_planned, none_available or other. One exception: a Cisco vendor_fix is no_fix_planned when the advisory's Summary says, in wording EchelonGraph's parser reads, that Cisco will not release a fix, and none of its Summary, Fixed Software, Recommendations, Details or Affected Products notes says, by the parser's markers, that a fix exists; its source_category then stays vendor_fix, its source_subcategory names the note its text is from, and it carries no url. Wording the parser does not read leaves the item vendor_fix, so a Cisco vendor_fix is not a finding that a fix was released."
+ },
+ "product_count": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "product_ids": {
+ "anyOf": [
+ {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "source_category": {
+ "description": "The vendor's own name for the category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_subcategory": {
+ "description": "MSRC's SubType, e.g. Security Update; for a Cisco no_fix_planned item, the title of the note its text is from (Summary); null elsewhere.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "description": "The vendor's text, verbatim but for HTML markup removed, untested by EchelonGraph; at most 2,000 characters (text_truncated, text_chars). Empty, with text_chars 0, when vendor_text_withheld is true.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text_chars": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "text_truncated": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Each remediation the vendor lists, with its kind: the vendor's own category, or it may be no_fix_planned where a Cisco advisory's summary says no fix will be released."
+ },
+ "severity": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vendor": {
+ "description": "The vendor's slug. Each vendor's advisory data stays under its own licence, and EchelonGraph's terms add no restriction to it: redhat, Red Hat's security advisories, © Red Hat, Inc., licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/; source https://access.redhat.com/security/data); github, the GitHub Advisory Database, licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/; source https://github.com/github/advisory-database); microsoft, Microsoft's own terms (its advisory pages are not copied: the facts and EchelonGraph's title are served, with a link to Microsoft's advisory where it names a CVE ID); every other vendor, that vendor's own terms.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vendor_advisory_id": {
+ "description": "The vendor's own ID for the advisory (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx, or the CVE ID for Microsoft and Palo Alto Networks). With vendor, it is the key an advisory's detail is looked up by, as its advisory_id argument.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vendor_display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vendor_modified_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vendor_published_at": {
+ "description": "The date the vendor gives for the advisory.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vendor_text_withheld": {
+ "description": "true: the vendor's advisory page is not copied (Microsoft's): title is EchelonGraph's (Microsoft security update for its first CVE where it lists a vendor fix, Microsoft advisory otherwise, by its own ID when it names no CVE), and the advisory's description, summary, remediation, withdrawn_reason and each remediation's text are empty (instead, a detail's cve_records lists the first cve_records_cap CVEs it names, each with the CVE record's description or null, as cve_records says when); severity, cvss_v3_score, cvss_v3_vector, cve_ids, affected_products, the dates and the links are the vendor's facts, and, where the advisory names a CVE ID, references lead with the vendor's own advisory page.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "withdrawn": {
+ "description": "true: the vendor withdrew (rescinded) this advisory, so it is a withdrawn advisory, not a current one.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "withdrawn_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "withdrawn_reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "data_truncated": {
+ "description": "false: data is the answer whole. true: the structured result would pass 30,000 characters of JSON with data whole, so data is cut (DATA CUT): the entries of some of its lists keep only some of their fields, or the lists only some of their entries, truncated gives each, and no string is shortened. The same call with full: true returns data whole.",
+ "type": "boolean"
+ },
+ "freshness": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The producing radar's last completed check (last_run_at), where the API serves one."
+ },
+ "measured_at": {
+ "anyOf": [
+ {
+ "description": "An RFC 3339 instant.",
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation."
+ },
+ "method": {
+ "description": "How the numbers were produced.",
+ "type": "string"
+ },
+ "notes": {
+ "description": "Caveats, one sentence each.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "state": {
+ "description": "measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.",
+ "enum": [
+ "measured",
+ "not_assessed"
+ ],
+ "type": "string"
+ },
+ "truncated": {
+ "additionalProperties": {
+ "additionalProperties": {},
+ "properties": {
+ "returned": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "thinned": {
+ "const": true,
+ "type": "boolean"
+ },
+ "total": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "total",
+ "returned"
+ ],
+ "type": "object"
+ },
+ "description": "Present when data_truncated is true: each list of data that was cut, by its path in data (a dot between the names of an object and a list inside it), with total, its entries in the answer, returned, the entries data holds, and thinned, true when each of them keeps only some of its fields.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "state",
+ "measured_at",
+ "method",
+ "coverage",
+ "freshness",
+ "notes",
+ "data_truncated",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "coverage": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "vendor_window": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "description": "A vendor's window in what EchelonGraph holds: vendor, advisories (how many EchelonGraph holds from that vendor), earliest_vendor_published_at and latest_vendor_published_at (the earliest and latest vendor_published_at among them, null when none is held), held_since (the start of the window EchelonGraph has read that vendor's advisories from, before which an advisory may not be held; null when none is held or the API does not say; for a vendor with no history read it is when its feed was first read from, and can be years after earliest_vendor_published_at, since an older advisory is held when the vendor revised it later, not the ones published beside it; where history_scope is a part of the vendor's advisories, it is where that part is held from, and the rest is held from feed_held_since), feed_held_since (the start of the window the vendor's own feed has read every one of its advisories from, which is held_since as it would be without any history read; an advisory outside history_scope published before it may not be held; null when none is held or the API does not say), history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried), history_scope (what the vendor's history read covers: all, or reviewed for GitHub, whose read covers its reviewed advisories and not its unreviewed ones, which are held only from feed_held_since; a value the API adds later as it sends it; null for a vendor with no history read, or when the API does not say), and last_success_at (the vendor's last successful poll), collection_state (whether the vendor is being collected now, by EchelonGraph's feed-state rule: ok; partial, its polls succeed but held_back of the documents it lists could not be used, the oldest since held_back_since, and those advisories, or those revisions, may not be held while the rest of its feed is; failing, it is not being collected, and what it published after failing_since, its last successful poll, may not be held, whatever the window says; disabled, this deployment runs no collector for it (its held advisories are still served), so its window ends at last_success_at; a value the API adds later as it sends it, never read as ok), failing_since, held_back and held_back_since (each null when the API does not say).",
+ "properties": {
+ "advisories": {
+ "description": "How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "collection_state": {
+ "description": "Whether this vendor is being collected now, by EchelonGraph's feed-state rule: ok, partial, failing or disabled. ok: it is being collected. partial: its polls succeed, but held_back of the documents it lists could not be used, the oldest since held_back_since; those advisories, or those revisions, may not be held, and the rest of its feed is. failing: it is not being collected, and an advisory it published after failing_since, its last successful poll, may not be held, whatever the window says. disabled: this deployment runs no collector for it (its held advisories are still served), so its window ends at last_success_at, and an advisory it published after that may not be held. A value the API adds later is relayed as sent and is not read as ok. null when the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "earliest_vendor_published_at": {
+ "description": "The earliest vendor_published_at among them; null when none is held. Not where the window begins: see held_since.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "failing_since": {
+ "description": "While collection_state is failing, this vendor's last successful poll: an advisory it published after it may not be held, whatever the window says. null when it is not failing, when no successful poll is on record, or when the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "feed_held_since": {
+ "description": "The start of the window this vendor's own feed has read every one of its advisories from: held_since as it would be without any history read, and equal to it for a vendor with no history read. Where history_scope is a part of the vendor's advisories (reviewed: GitHub's history read covers its reviewed advisories only), an advisory outside it published before feed_held_since may not be held, however early held_since is. null when none is held or the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "held_back": {
+ "description": "How many of the documents this vendor lists EchelonGraph could not use (collection_state partial): those advisories, or those revisions, may not be held. 0 when none is held back; null when the API does not say.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "held_back_since": {
+ "description": "When the oldest held-back document first failed; null when none is held back or the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "held_since": {
+ "description": "The start of the window EchelonGraph has read this vendor's advisories from; null when none is held or the API does not say. An advisory this vendor published before it may not be held, even when earliest_vendor_published_at is older. Where history_scope is a part of the vendor's advisories (reviewed), it is where that part is held from; the rest is held from feed_held_since.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "history_backfill": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "enum": [
+ "complete",
+ "complete_reviewed_only",
+ "in_progress",
+ "not_started",
+ "not_supported"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "history_backfill: complete (the vendor's published history has been read back as far as its source goes), complete_reviewed_only (the vendor's reviewed advisories have been read back as far as its source goes and its unreviewed ones have not: GitHub's, history_scope reviewed), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."
+ },
+ "history_scope": {
+ "description": "What this vendor's history read covers: all (every advisory its archive publishes) or reviewed (GitHub: its reviewed advisories, not its unreviewed ones, which are held only from feed_held_since); a value the API adds later as it sends it. null for a vendor with no history read, or when the API does not say.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_success_at": {
+ "description": "This vendor's last successful poll; null when none is on record or the API does not say. While collection_state is disabled, the window ends here.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "latest_vendor_published_at": {
+ "description": "The latest vendor_published_at among them; null when none is held.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "vendor": {
+ "description": "The vendor slug.",
+ "type": "string"
+ },
+ "vendor_display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "vendor",
+ "vendor_display_name",
+ "advisories",
+ "earliest_vendor_published_at",
+ "latest_vendor_published_at",
+ "held_since",
+ "feed_held_since",
+ "history_backfill",
+ "history_scope",
+ "last_success_at",
+ "collection_state",
+ "failing_since",
+ "held_back",
+ "held_back_since"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."
+ }
+ },
+ "required": [
+ "vendor_window"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "error": {
+ "additionalProperties": false,
+ "properties": {
+ "kind": {
+ "description": "What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.",
+ "enum": [
+ "network",
+ "timeout",
+ "http",
+ "not_json",
+ "not_object",
+ "invalid_input",
+ "internal",
+ "unexpected_shape",
+ "radars"
+ ],
+ "type": "string"
+ },
+ "message": {
+ "description": "The cause: the API's own message, or what went wrong.",
+ "type": "string"
+ },
+ "path": {
+ "description": "The API path requested, when a request was made.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "anyOf": [
+ {
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The HTTP status, when the API answered one; 503 with kind internal and path null where this server was too busy to make the call."
+ }
+ },
+ "required": [
+ "kind",
+ "path",
+ "status",
+ "message"
+ ],
+ "type": "object"
+ },
+ "freshness": {
+ "type": "null"
+ },
+ "measured_at": {
+ "type": "null"
+ },
+ "method": {
+ "type": "null"
+ },
+ "notes": {
+ "description": "Caveats, one sentence each.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "state": {
+ "description": "failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.",
+ "enum": [
+ "failed",
+ "invalid_input"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state",
+ "measured_at",
+ "method",
+ "coverage",
+ "freshness",
+ "notes",
+ "error"
+ ],
+ "type": "object"
+ }
+]