Docs for user inviting via API

Please note: The ruby API has NOT yet been updated to provide this functionality, and the .rb files added for the docs are copies of other .rb files with the content changed - they have not been tested.

Curl and python api have been tested and both work.