OpenAPI

The primary format for representing the API for a service MUST be an API document that conforms to the OpenAPI specification. API documents using version 2 of OpenAPI (aka Swagger) SHOULD be updated to version 3.x as soon as practical.

The API document for a service MUST be a complete and accurate description of the operations and resource models exposed by service.