update an internal API