added some text on api specs