"PayloadDetail": { "type": "object", "properties": { "schemaVersion": { "type": "string", "description": "The supported schema version." }, "format": { "type": "array", "description": "The supported format. Presently, JSON is the only supported format.", "items": { "type": "string", "description": " For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/notification/types/api:FormatTypeEnum'>eBay API documentation</a>" } }, "deliveryProtocol": { "type": "string", "description": "The supported delivery protocols. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/notification/types/api:ProtocolEnum'>eBay API documentation</a>" }, "deprecated": { "type": "boolean", "description": "A deprecation indicator." } }, "description": "A type that describes the details about a topic's payload." }
The components.schemas.PayloadDetail.properties.deprecated actually violates OpenAPI spec. The 'deprecated' property can only be boolean. Because it is a property of 'properties', which is (according to the spec) Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced). (see https://swagger.io/specification/#schema-object)