API Versioning

When we release backwards-incompatible changes for the API, we release new dated versions. The current version is 2017-06-06.

All requests will use the lastest version, unless you override the API version. The changelog lists every available versions. Note that events generated by API requests will always be structured according to your account API version.

To set the API version on a specific request, send a Broid-Version header.

Example of a query with version headerAuthorization

1
2
3
$ curl https://api.broid.ai/v1/status \
   -H 'Authorization: Bearer <your_key>'
   -H "broid-Version: 2016-11-06"