added links to API references
defer and retry updates on failure or bad network