now fully compliant with API version 1.7 revision 3