def foo_view(request):
    """
    Your docs
    ---
    type:
      name:
        required: true
        type: string
      url:
        required: false
        type: url
      created_at:
        required: true
        type: string
        format: date-time
    serializer: .serializers.FooSerializer
    omit_serializer: false
    parameters_strategy: merge
    omit_parameters:
        - path
    parameters:
        - name: name
          description: Foobar long description goes here
          required: true
          type: string
          paramType: form
        - name: other_foo
          paramType: query
        - name: other_bar
          paramType: query
        - name: avatar
          type: file
    responseMessages:
        - code: 401
          message: Not authenticated
    """
How to show query parameter options in Django REST Framework - Swagger