updated API specification