fixes #2318 - API v2 documentation for parameters to include real paths ...

...rather than /references/:id