Versioning
The URL major version /v1 never changes. Behaviour changes ship as dated versions.
- Send
Sisoco-Version: YYYY-MM-DDto choose a version per request. Without it, your account's pinned version is used; accounts are pinned to the latest version at sign-up. The latest version is2026-11-14. - Every response echoes
Sisoco-Version; every webhook body carriesapi_versionand is rendered in your pinned version. - Additive changes need no new version: new optional fields, endpoints, event types and packs. Ignore fields you do not know.
- A breaking change ships only as a new dated version. Older versions keep working, by translation over the latest schema, for at least 12 months after a deprecation notice.
- An unknown version answers 400
invalid_version.
The changelog lists every version and every additive change.