sample-operation-schema-refs.yaml

openapi: 3.0.0
info:
  title: My microservice
  # The double quotes are necessary to prevent version from being
  # interpreted as a floating point number.
  version: "1.0"

paths:
  '/api/users/{userId}':
    post:
      # The tag "Users" will cause this to be generated as a client
      # class named UsersApi when using the typescript-fetch generator
      # (and possibly others).
      tags:
        - Users
      parameters:
        - name: userId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: 'restTypes.yml#/components/schemas/IUpdateUserRequestBody'
      responses:
        '200':
          description: The updated user.
          content:
            application/json:
              schema:
                $ref: 'restTypes.yml#/components/schemas/IUpdateUserResponseBody'