The v2 Content API is stable as of Ghost v2.10.0. The v2 Admin API is still under development (experimental) and not yet ready for production use.

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
Content API deprecated (Public API) stable
Admin API deprecated (Private API) 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.