Ubuntu Security API

An open, unauthenticated API over Canonical's vulnerability data — Ubuntu Security Notices (USNs), CVE records with CVSS3 scoring, and per-release support status. Canonical publishes a Swagger 2.0 contract for it at https://ubuntu.com/security/api/spec.json and a Swagger UI at /security/api/docs. It is the most agent-friendly surface Canonical operates: read-only, needs no credential, and answers the question "is my Ubuntu package affected by this CVE?" directly.

Operations 17

GET /security/compat/notices.json
GET /security/compat/notices/{notice_id}.json
GET /security/cves.json
GET /security/cves/{cve_id}.json
GET /security/notices.json
GET /security/notices/{notice_id}.json
GET /security/page/notices.json
GET /security/releases.json
GET /security/releases/{release_codename}.json
PUT /security/updates/cves.json
DELETE /security/updates/cves/{cve_id}.json
POST /security/updates/notices.json
DELETE /security/updates/notices/{notice_id}.json
PUT /security/updates/notices/{notice_id}.json
POST /security/updates/releases.json
DELETE /security/updates/releases/{release_codename}.json
PUT /security/updates/releases/{release_codename}.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/ubuntu-security-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

canonical-ubuntu-security-api-openapi.json Raw ↑
{"definitions":{"CVEAPI":{"properties":{"bugs":{"items":{"type":"string"},"type":"array"},"codename":{"type":"string","x-nullable":true},"cvss3":{"type":"number","x-nullable":true},"description":{"type":"string","x-nullable":true},"id":{"type":"string"},"impact":{"$ref":"#/definitions/CveImpact"},"mitigation":{"type":"string","x-nullable":true},"notes":{"items":{"$ref":"#/definitions/Note"},"type":"array"},"notices_ids":{"items":{"pattern":"(USN|LSN|SSN)-\\d{1,5}-\\d{1,2}","type":"string"},"type":"array"},"packages":{"items":{"$ref":"#/definitions/CvePackage"},"type":"array"},"patches":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","x-nullable":true},"priority":{"type":"string","x-nullable":true},"published":{"format":"date-time","type":"string","x-nullable":true},"references":{"items":{"type":"string"},"type":"array"},"status":{"type":"string","x-nullable":true},"tags":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","x-nullable":true},"ubuntu_description":{"type":"string","x-nullable":true},"updated_at":{"format":"date-time","type":"string","x-nullable":true}},"required":["id"],"type":"object"},"CVEAPIDetailed":{"properties":{"bugs":{"items":{"type":"string"},"type":"array"},"codename":{"type":"string","x-nullable":true},"cvss3":{"type":"number","x-nullable":true},"description":{"type":"string","x-nullable":true},"id":{"type":"string"},"impact":{"$ref":"#/definitions/CveImpact"},"mitigation":{"type":"string","x-nullable":true},"notes":{"items":{"$ref":"#/definitions/Note"},"type":"array"},"notices":{"items":{"$ref":"#/definitions/NoticeAPI"},"type":"array"},"notices_ids":{"items":{"pattern":"(USN|LSN|SSN)-\\d{1,5}-\\d{1,2}","type":"string"},"type":"array"},"packages":{"items":{"$ref":"#/definitions/CvePackage"},"type":"array"},"patches":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","x-nullable":true},"priority":{"type":"string","x-nullable":true},"published":{"format":"date-time","type":"string","x-nullable":true},"references":{"items":{"type":"string"},"type":"array"},"status":{"type":"string","x-nullable":true},"tags":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","x-nullable":true},"ubuntu_description":{"type":"string","x-nullable":true},"updated_at":{"format":"date-time","type":"string","x-nullable":true}},"required":["id"],"type":"object"},"CVEImport":{"properties":{"bugs":{"items":{"type":"string"},"type":"array"},"codename":{"type":"string","x-nullable":true},"cvss3":{"type":"number","x-nullable":true},"description":{"type":"string","x-nullable":true},"id":{"type":"string"},"impact":{"$ref":"#/definitions/CveImpactImport"},"mitigation":{"type":"string","x-nullable":true},"notes":{"items":{"$ref":"#/definitions/Note"},"type":"array"},"packages":{"items":{"$ref":"#/definitions/CvePackage"},"type":"array"},"patches":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","x-nullable":true},"priority":{"type":"string","x-nullable":true},"published":{"format":"date-time","type":"string","x-nullable":true},"references":{"items":{"type":"string"},"type":"array"},"status":{"type":"string","x-nullable":true},"tags":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","x-nullable":true},"ubuntu_description":{"type":"string","x-nullable":true},"updated_at":{"format":"date-time","type":"string","x-nullable":true}},"required":["id"],"type":"object"},"CVESummaryV2":{"properties":{"id":{"type":"string"},"notices_ids":{"items":{"type":"string"},"type":"array"}},"type":"object"},"CVEsAPI":{"properties":{"cves":{"items":{"$ref":"#/definitions/CVEAPIDetailed"},"type":"array"},"limit":{"type":"integer","x-nullable":true},"offset":{"type":"integer","x-nullable":true},"total_results":{"type":"integer"}},"type":"object"},"CreateNoticeImport":{"properties":{"cves":{"items":{"pattern":"(cve-|CVE-)\\d{4}-\\d{4,7}","type":"string"},"type":"array"},"description":{"type":"string","x-nullable":true},"id":{"pattern":"(USN|LSN|SSN)-\\d{1,5}-\\d{1,2}","type":"string"},"instructions":{"type":"string"},"is_hidden":{"type":"boolean"},"published":{"format":"date-time","type":"string"},"references":{"items":{"type":"string"},"type":"array"},"release_packages":{"additionalProperties":{"items":{"$ref":"#/definitions/NoticePackage"},"type":"array"},"type":"object"},"summary":{"type":"string"},"title":{"type":"string"}},"required":["id","instructions","published","summary","title"],"type":"object"},"CveBaseMetric":{"properties":{"cvssV3":{"$ref":"#/definitions/CvssV3"},"exploitabilityScore":{"type":"number","x-nullable":true},"impactScore":{"type":"number","x-nullable":true}},"type":"object"},"CveBaseMetricV4":{"properties":{"cvssV4":{"$ref":"#/definitions/CvssV4"}},"type":"object"},"CveBaseMetricV4Import":{"properties":{"cvssV4":{"allOf":[{"$ref":"#/definitions/CvssV4Import"}],"x-nullable":true}},"type":"object"},"CveImpact":{"properties":{"baseMetricV3":{"$ref":"#/definitions/CveBaseMetric"},"baseMetricV4":{"$ref":"#/definitions/CveBaseMetricV4"}},"type":"object"},"CveImpactImport":{"properties":{"baseMetricV3":{"$ref":"#/definitions/CveBaseMetric"},"baseMetricV4":{"$ref":"#/definitions/CveBaseMetricV4Import"}},"type":"object"},"CvePackage":{"properties":{"debian":{"type":"string"},"name":{"type":"string"},"source":{"type":"string"},"statuses":{"items":{"$ref":"#/definitions/Status"},"type":"array"},"ubuntu":{"type":"string"}},"required":["debian","name","source","ubuntu"],"type":"object"},"CvssV3":{"properties":{"attackComplexity":{"type":"string","x-nullable":true},"attackVector":{"type":"string","x-nullable":true},"availabilityImpact":{"type":"string","x-nullable":true},"baseScore":{"type":"number","x-nullable":true},"baseSeverity":{"type":"string","x-nullable":true},"confidentialityImpact":{"type":"string","x-nullable":true},"integrityImpact":{"type":"string","x-nullable":true},"privilegesRequired":{"type":"string","x-nullable":true},"scope":{"type":"string","x-nullable":true},"userInteraction":{"type":"string","x-nullable":true},"vectorString":{"type":"string","x-nullable":true},"version":{"type":"string","x-nullable":true}},"type":"object"},"CvssV4":{"properties":{"baseEnvironmentalScore":{"type":"number","x-nullable":true},"baseEnvironmentalSeverity":{"type":"string","x-nullable":true},"baseMetrics":{"$ref":"#/definitions/CvssV4BaseMetrics"},"baseScore":{"type":"number","x-nullable":true},"baseSeverity":{"type":"string","x-nullable":true},"baseThreatEnvironmentalScore":{"type":"number","x-nullable":true},"baseThreatEnvironmentalSeverity":{"type":"string","x-nullable":true},"baseThreatScore":{"type":"number","x-nullable":true},"baseThreatSeverity":{"type":"string","x-nullable":true},"environmentalMetrics":{"$ref":"#/definitions/CvssV4EnvironmentalMetrics"},"supplementalMetrics":{"$ref":"#/definitions/CvssV4SupplementalMetrics"},"threatMetrics":{"$ref":"#/definitions/CvssV4ThreatMetrics"},"vectorString":{"type":"string","x-nullable":true},"version":{"type":"string","x-nullable":true}},"type":"object"},"CvssV4BaseMetrics":{"properties":{"exploitabilityMetrics":{"$ref":"#/definitions/CvssV4ExploitabilityMetrics"},"subsequentSystemImpactMetrics":{"$ref":"#/definitions/CvssV4SubsequentSystemImpactMetrics"},"vulnerableSystemImpactMetrics":{"$ref":"#/definitions/CvssV4VulnerableSystemImpactMetrics"}},"type":"object"},"CvssV4BaseMetricsImport":{"properties":{"exploitabilityMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4ExploitabilityMetrics"}],"x-nullable":true},"subsequentSystemImpactMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4SubsequentSystemImpactMetrics"}],"x-nullable":true},"vulnerableSystemImpactMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4VulnerableSystemImpactMetrics"}],"x-nullable":true}},"type":"object"},"CvssV4EnvironmentalMetrics":{"properties":{"modifiedBaseMetrics":{"$ref":"#/definitions/CvssV4ModifiedBaseMetrics"},"securityRequirements":{"$ref":"#/definitions/CvssV4SecurityRequirements"}},"type":"object"},"CvssV4EnvironmentalMetricsImport":{"properties":{"modifiedBaseMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4ModifiedBaseMetricsImport"}],"x-nullable":true},"securityRequirements":{"allOf":[{"$ref":"#/definitions/CvssV4SecurityRequirements"}],"x-nullable":true}},"type":"object"},"CvssV4ExploitabilityMetrics":{"properties":{"attackComplexity":{"type":"string","x-nullable":true},"attackRequirements":{"type":"string","x-nullable":true},"attackVector":{"type":"string","x-nullable":true},"privilegesRequired":{"type":"string","x-nullable":true},"userInteraction":{"type":"string","x-nullable":true}},"type":"object"},"CvssV4Import":{"properties":{"baseEnvironmentalScore":{"type":"number","x-nullable":true},"baseEnvironmentalSeverity":{"type":"string","x-nullable":true},"baseMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4BaseMetricsImport"}],"x-nullable":true},"baseScore":{"type":"number","x-nullable":true},"baseSeverity":{"type":"string","x-nullable":true},"baseThreatEnvironmentalScore":{"type":"number","x-nullable":true},"baseThreatEnvironmentalSeverity":{"type":"string","x-nullable":true},"baseThreatScore":{"type":"number","x-nullable":true},"baseThreatSeverity":{"type":"string","x-nullable":true},"environmentalMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4EnvironmentalMetricsImport"}],"x-nullable":true},"supplementalMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4SupplementalMetrics"}],"x-nullable":true},"threatMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4ThreatMetrics"}],"x-nullable":true},"vectorString":{"type":"string","x-nullable":true},"version":{"type":"string","x-nullable":true}},"type":"object"},"CvssV4ModifiedBaseMetrics":{"properties":{"exploitabilityMetrics":{"$ref":"#/definitions/CvssV4ExploitabilityMetrics"},"subsequentSystemImpactMetrics":{"$ref":"#/definitions/CvssV4SubsequentSystemImpactMetrics"},"vulnerableSystemImpactMetrics":{"$ref":"#/definitions/CvssV4VulnerableSystemImpactMetrics"}},"type":"object"},"CvssV4ModifiedBaseMetricsImport":{"properties":{"exploitabilityMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4ExploitabilityMetrics"}],"x-nullable":true},"subsequentSystemImpactMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4SubsequentSystemImpactMetrics"}],"x-nullable":true},"vulnerableSystemImpactMetrics":{"allOf":[{"$ref":"#/definitions/CvssV4VulnerableSystemImpactMetrics"}],"x-nullable":true}},"type":"object"},"CvssV4SecurityRequirements":{"properties":{"availabilityRequirements":{"type":"string","x-nullable":true},"confidentialityRequirements":{"type":"string","x-nullable":true},"integrityRequirements":{"type":"string","x-nullable":true}},"type":"object"},"CvssV4SubsequentSystemImpactMetrics":{"properties":{"availabilityImpact":{"type":"string","x-nullable":true},"confidentialityImpact":{"type":"string","x-nullable":true},"integrityImpact":{"type":"string","x-nullable":true}},"type":"object"},"CvssV4SupplementalMetrics":{"properties":{"automatable":{"type":"string","x-nullable":true},"providerUrgency":{"type":"string","x-nullable":true},"recovery":{"type":"string","x-nullable":true},"safety":{"type":"string","x-nullable":true},"valueDensity":{"type":"string","x-nullable":true},"vulnerabilityResponseEffort":{"type":"string","x-nullable":true}},"type":"object"},"CvssV4ThreatMetrics":{"properties":{"exploitMaturity":{"type":"string","x-nullable":true}},"type":"object"},"CvssV4VulnerableSystemImpactMetrics":{"properties":{"availabilityImpact":{"type":"string","x-nullable":true},"confidentialityImpact":{"type":"string","x-nullable":true},"integrityImpact":{"type":"string","x-nullable":true}},"type":"object"},"Message":{"properties":{"message":{"type":"string"}},"type":"object"},"MessageWithErrors":{"properties":{"errors":{"type":"string"},"message":{"type":"string"}},"type":"object"},"Note":{"properties":{"author":{"type":"string"},"note":{"type":"string"}},"required":["author","note"],"type":"object"},"NoticeAPI":{"properties":{"cves_ids":{"items":{"pattern":"(cve-|CVE-)\\d{4}-\\d{4,7}","type":"string"},"type":"array"},"description":{"type":"string","x-nullable":true},"id":{"pattern":"(USN|LSN|SSN)-\\d{1,5}-\\d{1,2}","type":"string"},"instructions":{"type":"string"},"is_hidden":{"type":"boolean"},"published":{"format":"date-time","type":"string"},"references":{"items":{"type":"string"},"type":"array"},"release_packages":{"additionalProperties":{"items":{"$ref":"#/definitions/NoticePackage"},"type":"array"},"type":"object"},"summary":{"type":"string"},"title":{"type":"string"},"type":{"type":"string"}},"required":["id","instructions","published","summary","title"],"type":"object"},"NoticeAPIDetailed":{"properties":{"cves":{"items":{"$ref":"#/definitions/CVEAPI"},"type":"array"},"cves_ids":{"items":{"pattern":"(cve-|CVE-)\\d{4}-\\d{4,7}","type":"string"},"type":"array"},"description":{"type":"string","x-nullable":true},"id":{"pattern":"(USN|LSN|SSN)-\\d{1,5}-\\d{1,2}","type":"string"},"instructions":{"type":"string"},"is_hidden":{"type":"boolean"},"published":{"format":"date-time","type":"string"},"references":{"items":{"type":"string"},"type":"array"},"related_notices":{"items":{"$ref":"#/definitions/RelatedNotices"},"type":"array"},"release_packages":{"additionalProperties":{"items":{"$ref":"#/definitions/NoticePackage"},"type":"array"},"type":"object"},"releases":{"items":{"$ref":"#/definitions/NoticeReleases"},"type":"array"},"summary":{"type":"string"},"title":{"type":"string"},"type":{"type":"string"}},"required":["id","instructions","published","summary","title"],"type":"object"},"NoticeAPIDetailedSchemaV2":{"properties":{"cves":{"items":{"$ref":"#/definitions/CVESummaryV2"},"type":"array"},"cves_ids":{"items":{"pattern":"(cve-|CVE-)\\d{4}-\\d{4,7}","type":"string"},"type":"array"},"description":{"type":"string","x-nullable":true},"id":{"pattern":"(USN|LSN|SSN)-\\d{1,5}-\\d{1,2}","type":"string"},"instructions":{"type":"string"},"is_hidden":{"type":"boolean"},"published":{"format":"date-time","type":"string"},"references":{"items":{"type":"string"},"type":"array"},"related_notices":{"items":{"type":"string"},"type":"array"},"release_packages":{"additionalProperties":{"items":{"$ref":"#/definitions/NoticePackage"},"type":"array"},"type":"object"},"releases":{"items":{"$ref":"#/definitions/NoticeReleases"},"type":"array"},"summary":{"type":"string"},"title":{"type":"string"},"type":{"type":"string"}},"required":["id","instructions","published","summary","title"],"type":"object"},"NoticeImport":{"properties":{"cves":{"items":{"pattern":"(cve-|CVE-)\\d{4}-\\d{4,7}","type":"string"},"type":"array"},"description":{"type":"string","x-nullable":true},"id":{"pattern":"(USN|LSN|SSN)-\\d{1,5}-\\d{1,2}","type":"string"},"instructions":{"type":"string"},"is_hidden":{"type":"boolean"},"published":{"format":"date-time","type":"string"},"references":{"items":{"type":"string"},"type":"array"},"release_packages":{"additionalProperties":{"items":{"$ref":"#/definitions/NoticePackage"},"type":"array"},"type":"object"},"summary":{"type":"string"},"title":{"type":"string"}},"required":["id","instructions","published","summary","title"],"type":"object"},"NoticePackage":{"properties":{"channel":{"type":"string","x-nullable":true},"description":{"type":"string"},"is_source":{"type":"boolean"},"is_visible":{"type":"boolean"},"name":{"type":"string"},"package_type":{"type":"string"},"pocket":{"type":"string"},"source_link":{"type":"string","x-nullable":true},"version":{"type":"string"},"version_link":{"type":"string","x-nullable":true}},"required":["is_source","name","version"],"type":"object"},"NoticeReleases":{"properties":{"codename":{"type":"string"},"support_tag":{"type":"string"},"version":{"type":"string"}},"type":"object"},"NoticesAPI":{"properties":{"limit":{"type":"integer","x-nullable":true},"notices":{"items":{"$ref":"#/definitions/NoticeAPIDetailed"},"type":"array"},"offset":{"type":"integer","x-nullable":true},"total_results":{"type":"integer"}},"type":"object"},"NoticesAPISchemaV2":{"properties":{"limit":{"type":"integer","x-nullable":true},"notices":{"items":{"$ref":"#/definitions/NoticeAPIDetailedSchemaV2"},"type":"array"},"offset":{"type":"integer","x-nullable":true},"total_results":{"type":"integer"}},"type":"object"},"PageNoticeAPI":{"properties":{"cves_ids":{"items":{"pattern":"(cve-|CVE-)\\d{4}-\\d{4,7}","type":"string"},"type":"array"},"description":{"type":"string","x-nullable":true},"id":{"pattern":"(USN|LSN|SSN)-\\d{1,5}-\\d{1,2}","type":"string"},"published":{"format":"date-time","type":"string"},"releases":{"items":{"$ref":"#/definitions/NoticeReleases"},"type":"array"},"summary":{"type":"string"},"title":{"type":"string"},"type":{"type":"string"}},"required":["id","published","summary","title"],"type":"object"},"PageNoticesAPI":{"properties":{"limit":{"type":"integer","x-nullable":true},"notices":{"items":{"$ref":"#/definitions/PageNoticeAPI"},"type":"array"},"offset":{"type":"integer","x-nullable":true},"total_results":{"type":"integer"}},"type":"object"},"RelatedNotices":{"properties":{"id":{"type":"string"},"packages":{"type":"string"}},"type":"object"},"Release":{"properties":{"codename":{"type":"string"},"development":{"type":"boolean"},"esm_expires":{"format":"date-time","type":"string"},"lts":{"type":"boolean"},"name":{"type":"string"},"release_date":{"format":"date-time","type":"string"},"support_expires":{"format":"date-time","type":"string"},"version":{"type":"string"}},"required":["codename","development","esm_expires","lts","name","release_date","support_expires","version"],"type":"object"},"ReleaseAPI":{"properties":{"codename":{"type":"string"},"development":{"type":"boolean"},"esm_expires":{"format":"date-time","type":"string"},"lts":{"type":"boolean"},"name":{"type":"string"},"release_date":{"format":"date-time","type":"string"},"support_expires":{"format":"date-time","type":"string"},"support_tag":{"type":"string"},"version":{"type":"string"}},"required":["codename","development","esm_expires","lts","name","release_date","support_expires","version"],"type":"object"},"ReleasesAPI":{"properties":{"releases":{"items":{"$ref":"#/definitions/ReleaseAPI"},"type":"array"}},"type":"object"},"Status":{"properties":{"component":{"type":"string","x-nullable":true},"description":{"type":"string","x-nullable":true},"pocket":{"type":"string","x-nullable":true},"release_codename":{"type":"string"},"status":{"type":"string"}},"required":["release_codename","status"],"type":"object"},"UpdateRelease":{"properties":{"codename":{"type":"string"},"development":{"type":"boolean"},"esm_expires":{"format":"date-time","type":"string"},"lts":{"type":"boolean"},"name":{"type":"string"},"release_date":{"format":"date-time","type":"string"},"support_expires":{"format":"date-time","type":"string"},"version":{"type":"string"}},"required":["codename","development","esm_expires","lts","name","release_date","support_expires","version"],"type":"object"}},"info":{"title":"Ubuntu Security API","version":"v1"},"paths":{"/security/compat/notices.json":{"get":{"parameters":[{"description":"Any string - Selects notices that have either id, details or cves.id matching it.","in":"query","name":"details","required":false,"type":"string","x-nullable":true},{"description":"CVE ID to filter notices by.","in":"query","name":"cve_id","required":false,"type":"string","x-nullable":true},{"description":"Comma-separated list of CVE IDs to filter notices by.","in":"query","name":"cves","required":false,"type":"string","x-nullable":true},{"description":"Ubuntu release codename to filter notices by.example: `\"noble\"`.","in":"query","name":"release","required":false,"type":"string","x-nullable":true},{"default":10,"description":"Number of Notices per response.Defaults to `10`. Max `20`.","in":"query","maximum":20,"minimum":1,"name":"limit","required":false,"type":"integer","x-nullable":true},{"default":0,"description":"Number of Notices to omit from response.Defaults to `0`.","in":"query","name":"offset","required":false,"type":"integer","x-nullable":true},{"default":"newest","description":"Select order: choose `oldest` for ASC order; `newest` for DESC order. Default is `newest`.","in":"query","name":"order","required":false,"type":"string","x-nullable":true},{"default":false,"description":"True or False if you want to select hidden notices. Default is `false`.","in":"query","name":"show_hidden","required":false,"type":"boolean","x-nullable":true}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/NoticesAPI"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}},"/security/compat/notices/{notice_id}.json":{"get":{"parameters":[{"description":"True or False if you want to select hidden notices. Default is `false`.","in":"query","name":"show_hidden","required":false,"type":"boolean","x-nullable":true},{"in":"path","name":"notice_id","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/NoticeAPIDetailed"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}}}}},"/security/cves.json":{"get":{"parameters":[{"description":"Any string -  Selects CVEs that have either id, description or ubuntu_description matching it","in":"query","name":"q","required":false,"type":"string","x-nullable":true},{"collectionFormat":"multi","description":"CVE priority","in":"query","items":{"type":"string"},"name":"priority","required":false,"type":"array","x-nullable":true},{"description":"Package name","in":"query","name":"package","required":false,"type":"string","x-nullable":true},{"description":"Number of CVEs per response. Defaults to 10. Max 20.","in":"query","maximum":20,"minimum":1,"name":"limit","required":false,"type":"integer","x-nullable":true},{"description":"Number of CVEs to omit from response. Defaults to 0.","in":"query","name":"offset","required":false,"type":"integer","x-nullable":true},{"collectionFormat":"multi","description":"Package component","in":"query","items":{"type":"string"},"name":"component","required":false,"type":"array","x-nullable":true},{"collectionFormat":"multi","description":"List of release codenames ","in":"query","items":{"type":"string"},"name":"version","required":false,"type":"array","x-nullable":true},{"description":"CVE status","enum":["not-in-ubuntu","active","rejected"],"in":"query","name":"cve_status","required":false,"type":"string","x-nullable":true},{"collectionFormat":"multi","description":"List of package statuses","in":"query","items":{"type":"string"},"name":"status","required":false,"type":"array","x-nullable":true},{"default":"descending","description":"Select `ascending` or `oldest` (depreciated) for ASC order;leave empty for descending order","enum":["oldest, descending, ascending"],"in":"query","name":"order","required":false,"type":"string"},{"description":"Select `priority` to group CVEs by highest to lowest priority","enum":["priority"],"in":"query","name":"group_by","required":false,"type":"string","x-nullable":true},{"default":"published","description":"Select `updated` to sort by most recently updated CVEs;leave empty to sort by publish date","enum":["updated","published"],"in":"query","name":"sort_by","required":false,"type":"string"},{"description":"True or False if you want to select hidden notices. Default is False.","in":"query","name":"show_hidden","required":false,"type":"boolean","x-nullable":true}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/CVEsAPI"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}},"/security/cves/{cve_id}.json":{"get":{"parameters":[{"description":"True or False if you want to select hidden notices. Default is False.","in":"query","name":"show_hidden","required":false,"type":"boolean","x-nullable":true},{"in":"path","name":"cve_id","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/CVEAPIDetailed"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}}}}},"/security/notices.json":{"get":{"parameters":[{"description":"Any string - Selects notices that have either id, details or cves.id matching it.","in":"query","name":"details","required":false,"type":"string","x-nullable":true},{"description":"CVE ID to filter notices by.","in":"query","name":"cve_id","required":false,"type":"string","x-nullable":true},{"description":"Comma-separated list of CVE IDs to filter notices by.","in":"query","name":"cves","required":false,"type":"string","x-nullable":true},{"description":"Ubuntu release codename to filter notices by.example: `\"noble\"`.","in":"query","name":"release","required":false,"type":"string","x-nullable":true},{"default":10,"description":"Number of Notices per response.Defaults to `10`. Max `20`.","in":"query","maximum":20,"minimum":1,"name":"limit","required":false,"type":"integer","x-nullable":true},{"default":0,"description":"Number of Notices to omit from response.Defaults to `0`.","in":"query","name":"offset","required":false,"type":"integer","x-nullable":true},{"default":"newest","description":"Select order: choose `oldest` for ASC order; `newest` for DESC order. Default is `newest`.","in":"query","name":"order","required":false,"type":"string","x-nullable":true},{"default":false,"description":"True or False if you want to select hidden notices. Default is `false`.","in":"query","name":"show_hidden","required":false,"type":"boolean","x-nullable":true}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/NoticesAPISchemaV2"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}},"/security/notices/{notice_id}.json":{"get":{"parameters":[{"description":"True or False if you want to select hidden notices. Default is `false`.","in":"query","name":"show_hidden","required":false,"type":"boolean","x-nullable":true},{"in":"path","name":"notice_id","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/NoticeAPIDetailedSchemaV2"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}}}}},"/security/page/notices.json":{"get":{"parameters":[{"description":"Any string - Selects notices that have either id, details or cves.id matching it.","in":"query","name":"details","required":false,"type":"string","x-nullable":true},{"description":"CVE ID to filter notices by.","in":"query","name":"cve_id","required":false,"type":"string","x-nullable":true},{"description":"Comma-separated list of CVE IDs to filter notices by.","in":"query","name":"cves","required":false,"type":"string","x-nullable":true},{"collectionFormat":"multi","description":"List of release codenames ","in":"query","items":{"type":"string"},"name":"release","required":false,"type":"array","x-nullable":true},{"default":10,"description":"Number of Notices per response.Defaults to `10`. Max `20`.","in":"query","maximum":20,"minimum":1,"name":"limit","required":false,"type":"integer","x-nullable":true},{"default":0,"description":"Number of Notices to omit from response.Defaults to `0`.","in":"query","name":"offset","required":false,"type":"integer","x-nullable":true},{"default":"newest","description":"Select order: choose `oldest` for ASC order; `newest` for DESC order. Default is `newest`.","in":"query","name":"order","required":false,"type":"string","x-nullable":true},{"default":false,"description":"True or False if you want to select hidden notices. Default is `false`.","in":"query","name":"show_hidden","required":false,"type":"boolean","x-nullable":true}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/PageNoticesAPI"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}},"/security/releases.json":{"get":{"parameters":[],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/ReleasesAPI"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}}}}},"/security/releases/{release_codename}.json":{"get":{"parameters":[{"in":"path","name":"release_codename","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/ReleaseAPI"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}}}}},"/security/updates/cves.json":{"put":{"parameters":[{"in":"body","name":"body","required":false,"schema":{"items":{"$ref":"#/definitions/CVEImport"},"type":"array"}}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/Message"}},"400":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}},"413":{"description":"","schema":{"$ref":"#/definitions/Message"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}},"/security/updates/cves/{cve_id}.json":{"delete":{"parameters":[{"in":"path","name":"cve_id","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/Message"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}}}}},"/security/updates/notices.json":{"post":{"parameters":[{"in":"body","name":"body","required":false,"schema":{"$ref":"#/definitions/CreateNoticeImport"}}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/Message"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}},"/security/updates/notices/{notice_id}.json":{"delete":{"parameters":[{"in":"path","name":"notice_id","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/Message"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}}}},"put":{"parameters":[{"in":"body","name":"body","required":false,"schema":{"$ref":"#/definitions/NoticeImport"}},{"in":"path","name":"notice_id","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/Message"}},"404":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}},"/security/updates/releases.json":{"post":{"parameters":[{"in":"body","name":"body","required":false,"schema":{"$ref":"#/definitions/Release"}}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/Message"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}},"/security/updates/releases/{release_codename}.json":{"delete":{"parameters":[{"in":"path","name":"release_codename","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/Message"}},"400":{"description":"","schema":{"$ref":"#/definitions/Message"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}}}},"put":{"parameters":[{"in":"body","name":"body","required":false,"schema":{"$ref":"#/definitions/UpdateRelease"}},{"in":"path","name":"release_codename","required":true,"type":"string"}],"responses":{"200":{"description":"","schema":{"$ref":"#/definitions/Message"}},"404":{"description":"","schema":{"$ref":"#/definitions/Message"}},"422":{"description":"","schema":{"$ref":"#/definitions/MessageWithErrors"}}}}}},"swagger":"2.0.0"}