Sisoco Oneby Sisoco Partners

Versioning

The URL major version /v1 never changes. Behaviour changes ship as dated versions.

  • Send Sisoco-Version: YYYY-MM-DD to 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 is 2026-11-14.
  • Every response echoes Sisoco-Version; every webhook body carries api_version and 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.