updated API description