Building Data API v2 at Webflow: Part 1

Between 2015 and 2016, Webflow launched its REST API, initially focusing on allowing third-party developers to query the Webflow CMS and respond to site events. As the API expanded with new features and developer requests, it became fragmented, presenting challenges such as inconsistent error formats and complex permissions. By early 2023, the Developer Platform team undertook a comprehensive audit to address these issues, conducting a "papercuts" exercise to identify and categorize pain points, including API response errors, ergonomics, and nomenclature. They developed a public API style guide to standardize design principles and best practices, aiming for consistency and preventing future fragmentation. The process involved prioritizing issues, updating documentation, and laying out a structured redesign plan. The initiative underscores the importance of continuous iteration and reflection in building a robust developer platform, emphasizing the need for collaboration and strategic planning. The blog series will continue to explore further efforts in API versioning, rollout lifecycle, and communication with customers.