Changelog and versioning

How versioning works

• The major version is in the path. Within /v1, changes are additive only.
• A date pins the details. The first request from a key with no pin of its own pins your organisation's version. Send Vojo-Version to choose one for a single request. See Versioning.
• Deprecations get notice. A deprecated endpoint sends Deprecation and Sunset headers, with at least 180 days' notice.

Because /v1 grows by addition, your client should ignore fields it doesn't recognise.

Changelog

2026-11-08: real-time scores

• New webhook event verification.score.preliminary: a play's score as soon as its Passport report is complete, before it's final.
• verification.score is renamed verification.score.final. The old name still works with the same payload, and an endpoint subscribed to both receives one event per play.

2026-10-07: early access

The first /v1 API version, for CMS integrators.

• Secret-key authentication, scopes, cursor pagination, Idempotency-Key on creates, and application/problem+json errors.
• Screens, screen size ranges, sites (create and list), wrappers, plays and play events, evidence composition, webhook endpoints, and the organisation.
• Webhook secret rolls with an overlap period, and two v1 signatures during that overlap.
• A verification.score subscription made through /v1 sends plays whose score becomes final after you subscribe, and never backfills.

The rest of the /v1 contract isn't served yet and returns 404. The API reference marks those endpoints.