added api comments