revised api