@ikitommi if you add a :description to a Spec Record it doesn't show up in the description in swagger if its a body param but it does if its a path param.

oh, that’s not intended. The code seems to retain the :description (https://github.com/metosin/spec-tools/blob/master/src/spec_tools/json_schema.cljc#L264-L276), but we might need to lift it so some other field for the swagger body-params. The test for the swagger params is here: https://github.com/metosin/spec-tools/blob/master/test/cljc/spec_tools/swagger/core_test.cljc#L188-L240.

PR welcome to fix that.