Versions

The major version is in the address: /v1. Every response also carries the Rustine-Version header, the date of the contract that answered (2026-10-13 today). Log it: if a behaviour surprises you, it tells which version of the contract produced it.

What Rustine promises within v1

Nothing that works today breaks:

• no field removed or renamed, no type changed;
• no new required parameter;
• no route removed;
• the format of errors and lists stays the same, and an error code keeps its meaning.

What may happen without notice

Additions, which your code must be able to ignore. The date in Rustine-Version then moves forward:

• new routes;
• new fields in answers;
• new optional parameters;
• new values in a closed list (status, severity, family…): plan an “other” case;
• new error codes: handle an unknown code by its type.

A v2, some day

A change that would break your code will come as a new version, /v2, announced in the Changelog and by email to key holders. v1 will keep answering for at least 12 months after that announcement, while you migrate; its end date will be given in the announcement.