In fact, is there any reason why we wouldn't just create the whole `api` method from the spec here, rather than do little bits in different places?

In `_appendToApi` we add the description, operations, responseClass to it. Presumably somewhere else we are adding the `method` to it. What else gets added to the `api`, and why couldn't we just do it all here?