Breaking API change made 2-3 days ago! All systems down!

Golioth Cloud Help
1

Our entire fleet of devices went down after a breaking API change made 2-3 days ago. The automate system came VERY close to emailing our entire customer base telling them that their devices failed before we found the error.
One of the fundamental tenants of an API is to not create breaking changes without updating the API revision, but it happened this week.

API calls that worked fine last week now return “message”: “items per page cannot exceed 100” so the item limit on the API was apparently added\changed without an API revision update, or even any advanced notice. As with most items, there is no documentation at all on “perPage” and what it’s usage or limits are.

It not only broke our production code but all of our development tools (some of them simple Excel sheets that don’t have the ability to do paging)

Can we get this change reverted and get assurances from Golioth that no more breaking API changes will be made in the future without a revision update?

2

John,

Thank you for reaching out and we apologize for the interruption. We have taken appropriate steps to address the issue and your systems should be able to function as they were previously. We will be taking further steps to ensure that all API limits are extensively documented and that any changes to those limits are more clearly communicated in the future.

3

Thank you. Good to hear it’s being taken seriously.