updated comments in api