We’ve just put version 1.1 of the Context.IO email API live. Please note that we’ve put this version of the API live as a way of getting feedback. While unlikely, we may still make some tweaks in it before before it becomes official. We will email you as well as blog and tweet this once it is.
Aside from changes to the API itself, we moved the documentation from developer.context.io to http://context.io/docs and we’ve integrated commenting on every documentation page. Feel free to ask questions about an API call directly on the page in question, we’ll make sure to answer within the comments as well for the benefits of all future readers. We encourage you to continue using our support forum (http://support.context.io) for any ideas or problems.
About bumping version numbers
The logic behind bumping up the version number of the API versus simply adding the to current version is pretty simple. Whenever something new is ready, we ask ourselves these questions:
- Was an API call renamed or removed?
- Were data properties removed or renamed from responses of existing calls?
- Were arguments renamed or removed for existing API calls?
If the answer to one of the questions is yes, a new version will be created. In other words, if the changes about to be made available are likely to affect code using the API, a new version will be created to make sure your code will still work until you’re ready to move up the new version.