openapi: 3.0.0 info: title: Examples of the new example object using a $ref and a external link version: 1.0.0 paths: '/pets': get: responses: '200': content: application/json: schema: $ref: '#/components/schemas/Pet' examples: dog: summary: An example of a dog with a cat's name value: name: Puma petType: Dog color: Black gender: Female breed: Mixed frog: $ref: '#/components/examples/frog-example' cat: summary: An example of a cat externalValue: '/examples/cat.json'