Update API calls according to specification
add api documentation