swagger.rb

class FooController < ApplicationController
  create_endpoint = swagger_method :create do |create|
    create.summary "List all the Foos"
    create.header :auth, :"X-AUTH-TOKEN", :required
    create.param :new_foo, {name: String, address: {zip: String, city: String}}
  end

  def index
    query = create_endpoint.parse(request)
    auth_header = query.header[:auth]
    body = query.param[:new_foo]
    if body.valid?
      name = body.name
      city = body.address.city
    end
  end
end