On Thursday, April 21st we will be deploying Version 2 of our API. This version is quite different from our existing API V1.

IMPORTANT: Your code or sketches will need to be updated if you are using the REST API.

From now until Thursday, you will want to update your code or sketches to change ‘/api/…’ to ‘/api/v1/’ so that you continue using v1 of the API until you are ready to upgrade to the latest version.

Here are some of the highlights (not including bug fixes):

NEW

  • New permission system that will allow for sharing read and write access to your feeds, groups, & dashboards with other users.
  • New AWS inspired HTTP request signing to help avoid exposing the user’s AIO key over insecure connections.
  • Dashboards, blocks, & triggers will be able to be modified via the REST API.

CHANGES

  • Username will be a required component of the URL.
  • You will no longer be able to access feeds & groups via numeric ID. Feed key & group keys will be used as the unique identifier in API v2.
  • Feeds will be able to be added to many groups, and the feed’s data will be namespaced to the group the data is pushed to. You will also be able to access all of the feed’s data by accessing the feed directly.