diff --git a/OSCALRestOpenAPI.json b/OSCALRestOpenAPI.json index b35991d..449ce6e 100644 --- a/OSCALRestOpenAPI.json +++ b/OSCALRestOpenAPI.json @@ -1,5 +1,5 @@ { - "openapi": "3.1.0", + "openapi": "3.0.3", "info": { "title": "OSCAL REST", "description": "This is an open-source REST API specification for exchanging [OSCAL](https://pages.nist.gov/OSCAL/) content between tools and organizations.\n\nThe _OSCAL REST OpenAPI Specification_ addresses OSCAL XML, JSON and YAML content for all seven OSCAL models. Each OSCAL model has a primary set of REST API methods and endpoints for the OSCAL content itself, as well as methods and endpoints for snapshots and attachments. OSCAL profiles also have methods and endpoints for live profile resolution and snapshots of resolved profiles.\n\nFor an overview and more information, visit [https://docs.oscal.io/docs/oscal-rest-openapi](https://docs.oscal.io/docs/oscal-rest-openapi)\n\n---\n\n**Known-Issue: OSCAL XML Representation**\n\nThere is a [known-issue](https://github.com/OAI/OpenAPI-Specification/issues/630) that prevents proper expression of OSCAL XML in OpenAPI.\n\nWhen the specification calls for OSCAL content to be accepted or returned, the content must be fully OSCAL valid. Even if the specification shows a non-compliant schema or example.", @@ -21,6 +21,9 @@ "servers": [ { "url": "http://localhost:8080/oscal/v1" + }, + { + "url": "https://raw.githubusercontent.com/" } ], "tags": [ @@ -1686,15 +1689,6 @@ } } }, - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/OSCALSnapshotAttributes" - } - } - } - }, "security": [ { "oscal_auth": [ @@ -14355,7 +14349,7 @@ }, "snapshot": { "type": "object", - "ref$" : "#components/schemas/OSCALSnapshotAttributes" + "$ref" : "#/components/schemas/OSCALSnapshotAttributes" } } },