openapi: 3.0.0
info:
  title: Providing example in nested refs
  version: '1.0'
paths:
  /nested-refs-with-example:
    get:
      summary: List Bank Accounts
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBankAccountsResponse'
components:
  schemas:
    EditableBankAccountParams:
      properties:
        name:
          type: string
        type:
          type: string
    ReadOnlyBankAccountParams:
      properties:
        url:
          type: string
          readOnly: true
        current_balance:
          type: number
          readOnly: true
    BankAccount:
      title: BankAccount
      type: object
      allOf:
        - $ref: '#/components/schemas/EditableBankAccountParams'
        - $ref: '#/components/schemas/ReadOnlyBankAccountParams'
      example:
        name: 'account-name'
        type: StandardBankAccount
        url: 'https://api.freeagent.com/v2/bank_accounts/4093'
        current_balance: 28742
    ListBankAccountsResponse:
      title: ListBankAccountsResponse
      type: object
      properties:
        bank_accounts:
          type: array
          items:
            $ref: '#/components/schemas/BankAccount'
tags:
  - name: Person
    description: Person Datatype