update with more API description