Versioning

The version is in the address: /v1.

Within v1 we only add: new fields, new endpoints, new optional parameters. Your code should ignore fields it does not know.
Anything that would break an existing integration comes as v2, announced in the changelog and by email, with v1 kept running for at least 6 months.