openapi: 3.0.0 info: title: Examples of the new example object version: 1.0.0 paths: '/names': get: responses: '200': content: 'application/json': schema: type: array items: type: string examples: list: summary: List of Names description: |- A long and _very_ detailed description of this representation that includes rich text. value: - Bob - Diane - Mary - Bill empty: summary: Empty value: [ ] 'application/xml': examples: list: summary: List of names value: "" empty: summary: Empty list value: "" 'text/plain': examples: list: summary: List of names value: "Bob,Diane,Mary,Bill" empty: summary: Empty value: ""