add api document came up with descussion with Hongbin