The goal here is to have a definition of api endpoints which can be used to generate documentation (iodocs for example). The "wrappers" entry allows each group or separate endpoint to specify wrappers around the endpoint implementation which can be used for auth checks, stats, ...

gistfile1.clj

(endpoints->handler
  (group "users"
         {:doc
          {:description "A group for users routes"
           :name "Users routes"}}
    (GET "/:id"
         {:doc
          {:description "Get a user"
           :name "get-user"
           :params {:id
                    {:type "string"
                     :description "The user id"}}}}
       {{:keys [id]} :params}
       stub)
    (PUT "/:id"
         {:wrappers [authenticated]
          :doc
           {:description "Update a user"
            :name "update-user"
            :params {:id
                      {:type "string"
                       :description "The user id"}}}}
       {{:keys [id]} :params}
       stub))

  (group "posts"
         {:doc
          {:description "A group for posts routes"
           :name "Posts routes"}}
    (GET "/:id"
         {:doc
          {:description "Get a post"
           :name "get-post"
           :params {:id
                     {:type "string"
                      :description "The post id"}}}}
       {{:keys [id]} :params}
       stub)))