Updated api design blog post