Add in the success path too
Merge pull request #64 from rivimey/feature/api-docs-v4

Additional description of v4 api and how to use it.