Skip to content

Guides

Versioning & changelog

The public API is versioned in the path (/v1) and evolves additively. We add fields and endpoints without bumping the version; breaking changes ship under a new version with a deprecation window.

Developer docs

2 min read

Stability promise

Within /v1 you can rely on:

  • New optional fields and endpoints may be added at any time — handle unknown fields gracefully.
  • Existing field names, types, and enum values won't change meaning under /v1.
  • Breaking changes ship as a new version (/v2) with advance notice and an overlap period.
  • Error codes are stable identifiers — branch on code, not on title or detail text.

Releases

2026-06 — v1 launch: posts, clients, accounts, agency, analytics (incl. per-entity drill-downs), reports, best-times, and media; API keys with rotation; OAuth 2.1 (PKCE + DCR); the remote MCP server.

versioningchangelog

FAQ

How will I be told about breaking changes?
Breaking changes only land in a new version path. We announce deprecations ahead of time and keep the previous version running through an overlap window.

Be first in line when SkedCast opens

Join the waitlist — agencies on it get early access and launch-day onboarding.