API Versioning
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.
| 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.