add api annotations