modified api specaccording to discussion