example_schema.yml

swagger: "2.0"
info:
  description: Simple example
  version: "1.0.0"
  title: Example
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
host: 127.0.0.1:8080
schemes:
  - http
paths:
  /jobs:
    post:
      description: "Test"
      responses:
        200:
          description: "Good"
      parameters:
        - schema:
            "$ref": "#/definitions/Item"
          name: "query"
          in: body
definitions:
  Item:
    type: object
    properties:
      # This is the field that I'd like to skip in the request.
      category_id:
        type: integer
      other_thing:
        type: string
    # It's not in the required list, so I'm assuming that means it's optional?
    required:
      - other_thing