Example for POST call

petstore-oas-post-simple-v1.yaml

paths:                                                      # all routes go under this
  "/pet":
    post:                                                   # define the type ie get/post/put/delete
      tags:
        - Pet
      summary: Add a new pet to the store
      requestBody:                                          # define the request body under this
        content:
          application/json:                                 # this shows that the request body is a JSON object
            schema:
              $ref: "#/components/schemas/Pet"
      responses:                                    
        "200":
          description: Success