what is the correct way to express optional query parameters? I've tried several variations of (s/optional-key) without luck

with ring-swagger? or compojure-api?

compojure-api. that seems to work, thanks!