Versioning

The Marky API uses date-based versioning, inspired by Stripe. This means the API evolves without breaking your existing integrations.

How it works

Every request returns a Marky-Version header with the API version used:

Marky-Version: 2026-04-08

You can pin your integration to a specific version by sending the header:

curl https://api.mymarky.ai/api/businesses \
  -H "Authorization: Bearer mk_live_your_key" \
  -H "Marky-Version: 2026-04-08"

If you don’t send the header, you get the latest version.

Non-breaking changes (new fields, new endpoints) are added without a version bump. Your existing code won’t break.
Breaking changes (removed fields, changed behavior) create a new version date. Your pinned version continues working until you’re ready to upgrade.

Version	Date	Notes
`2026-04-08`	April 8, 2026	Initial release