Operations
Changelog
Every change to the public contract, dated. Subscribe by RSS.
Every change to the public contract appears here, dated, with its category. Deprecations carry their removal date from the day they are announced.
Categories: Added (safe to ignore), Changed (behaviour you may observe), Fixed (a documented promise brought back in line), Deprecated (twelve-month window opens), Removed (window closed), Security.
Unreleased
Nothing pending.
2026-09-10
Added
- Response bodies are documented. Fifteen of eighteen operations now carry a response schema. The
three that do not are the capability operations:
invokeCapabilityreturns the payload of whichever capability was invoked, so it has no fixed shape. - Eighty-three fields carry a description, and forty-five carry an example — concentrated on
what a reader cannot guess: what a
nullscore means, which clock a freshness field measures, and why a cohort verdict does not qualify an individual axis. - Enum values are published on 128 fields. Where a field accepts a closed set, the contract now
lists it instead of declaring a bare
string. - The contract is downloadable at
/openapi.json— the same document the server publishes, importable into Postman, Insomnia, Bruno or a client generator. - Developer portal published at
developers.digitalyser.io, with a cookbook, a glossary and flow diagrams. - Public status page at status.digitalyser.io, with capability-level probes and an incident feed.
Nothing above changes a response. These are all documentation of behaviour that was already served: no field appeared, disappeared or changed meaning. A client written against the previous contract keeps working, and now has a schema to validate against.
Was this page helpful?