Refactor all API v2 docstrings

As API v1 tests will be rewritten the rafactor could happen when
updating the tests.
Merge pull request #1327 from elyezer/docstring-refactor-api-v2

Refactor all API v2 docstrings