update api specs in documentation