Fix annotations to match the example code

The code for the API annotations in the swagger guide are out of date. The explanation matches what is in the swagger example code but the code doesn't so the explanation doesn't make any sense. I fixed the code in the guide to be what is in the swagger example code.