API Versioning


Each major version of Ghost ships with at least 2 versions of the APIs. Each version of an API has a status, which indicates suitability for production use. The core API guide describes the purpose of each API.

Here is the current status of the APIs:

API v0.1 v2 v3
Content API deprecated maintenance stable
Admin API deprecated maintenance experimental

Stability Index:

  • experimental - being actively worked on, may receive breaking changes
  • stable - forward compatible changes only
  • maintenance - no changes, security fixes only
  • deprecated - scheduled for removal

Ghost major versions ship every 8-12 months, meaning code you write against our API today will be stable for a minimum of 2 years.