PLATFORM-576 add comments and update endpoint call types