Developer docs

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. Read more about Ghost’s architecture.

Here is the current status of the APIs:

APIv2v3v4
Content APIDeprecatedMaintenanceStable
Admin APIDeprecatedMaintenanceExperimental

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.