title: How to add multiple examples to a Swagger schema?
body: <p>I'm using Swagger with OAS3, since I need <code>anyOf</code> support. I have an API call that can take one of 2 possible schemas, an <code>account</code> or an <code>address</code>. The schema works well in Swagger: it shows, and validates. But the <code>example</code> value shows only the first schema. I created an <code>examples</code> array, per the documentation, but I have no idea where to add it:</p>
  <pre class="lang-js prettyprint-override"><code>const accountSchema = {
    description: 'schema for adding a new account',
    type: 'object',
    properties: {
      account: {
        type: 'object',
        properties: {
          userId: {type: 'number'},
          platformId: {type: 'number'},
          name: {type: 'string'},
          key: {type: 'string'},
          secret: {type: 'string'},
          test: {type: 'boolean'},
        },
        required: ['userId', 'platformId', 'name', 'key', 'secret']
      }
    },
  };
  
  const ethereumAddressSchema = {
    description: 'schema for adding a new ethereum address',
    type: 'object',
    properties: {
      ethereum: {
        type: 'object',
        properties: {
          userId: {type: 'number'},
          name: {type: 'string'},
          address: {type: 'string'},
          chainId: {type: 'number'},
        },
        required: ['userId','name', 'address']
      }
    }
  };
  
  const examples = [
    {
      account: {
        &quot;userId&quot;: 0,
        &quot;platformId&quot;: 0,
        &quot;name&quot;: &quot;string&quot;,
        &quot;key&quot;: &quot;string&quot;,
        &quot;secret&quot;: &quot;string&quot;,
        &quot;test&quot;: true
      },
    },
    {
      ethereum: {
        &quot;userId&quot;: 0,
        &quot;address&quot;: '0xfffffffffffffff',
        &quot;name&quot;: &quot;string&quot;,
        &quot;chainId&quot;: 1,
      }
    }
  ];
  
  const body = {
    anyOf: [accountSchema, ethereumAddressSchema]
  };
  
  const response = {
    type: 'object',
    properties: {
      accountId: {type: 'number'},
      reason: {type: 'string'}
    },
    required: []
  };
  
  const addAccountSchema = {
    description: 'Add a new account',
    tags: ['account'],
    produces: ['application/json'],
    summary: 'Add a new account',
    body,
    response: {
      200: {
        description: 'Account request valid',
        ...response
      },
      404: {
        description: 'Account request parameters not found',
        ...response
      },
      422: {
        description: 'Account request invalid',
        ...response
      }
    }
  };
  
  module.exports = addAccountSchema;
  </code></pre>
  <p>Where should I add the <code>examples</code> array, or is there a better way to show the user the 2 possible schemas in the UI?</p>