title: how to document swagger query parameter with json object input
body: <p>How do I define a JSON object value for a request parameter that is <code>in: query</code> (not <code>in: body</code>)?</p>
  
  <p>Example below:</p>
  
  <pre><code>paths:
    /schedules:
      get:
        summary: Gets the list of schedules
        description: |
          The schedules endpoint returns information about the configured schedules.
        parameters:
          - name: filter
            in: query
            description: &gt;
            Returns whether alert runs on matching schedule.
  
  
            Example request:
  
  
                {
                  "type": "a",
                  "start" : "b",
                  "stop" : "c"
                }
            required: true
            type: string
  </code></pre>
  
  <p>Because it's not <code>in: body</code>, I cannot use <code>schema</code>.</p>