Oracle has announced that Apiary reaches end of life on October 31, 2026, after which instances are deleted. Convert your API Blueprint to OpenAPI and ApiNotes will host the docs, from $0.
Apiary was an early API design and documentation tool built around API Blueprint, with a mock server and hosted docs. It has been in maintenance mode for years under Oracle, paid plans were discontinued in 2018, and the service is scheduled to stop on October 31, 2026. If your docs still live there, export them now.
ApiNotes hosts OpenAPI and Swagger 2.0 documents: a three-column reference, Try-it panel, search, version history and an automatic changelog. Convert your API Blueprint to OpenAPI, publish it, and you keep a mock server too. Starter is free; Team is $19/month.
| Feature | Apiary | ApiNotes |
|---|---|---|
| Basics | ||
| What it is | API Blueprint design + docs (end of life) | Hosted docs + changelog platform |
| Hosting included | ⚠️ Until October 31, 2026 | ✅ your-api.apinotes.io, CDN-cached |
| Custom domain | ⚠️ Limited | ✅ CNAME, TLS handled (Team) |
| Documentation | ||
| Layout | ⚠️ Two-column | ✅ Three-column reference |
| Code samples | ⚠️ Limited | ✅ 10+ languages per endpoint |
| Try-it console | ⚠️ Console on the hosted docs | ✅ Try-it panel with auth |
| Search | ⚠️ Limited | ✅ Full-text across endpoints and guides |
| Guides and prose pages | ⚠️ Within the Blueprint | ✅ Documentation editor |
| Server-side rendering / SEO | ⚠️ Hosted pages | ✅ SSR, indexable, per-project meta |
| Change management | ||
| Version history | ⚠️ Via the editor history | ✅ Every push kept, switch versions in docs |
| Automatic changelog | ❌ | ✅ Written from the spec diff on every push |
| Breaking-change detection | ❌ | ✅ Flagged per release |
| Email subscribers + RSS/JSON feed | ❌ | ✅ 25 on Starter, unlimited on Team |
| CI/CD and access | ||
| Publish from CI | ⚠️ CLI for Blueprint | ✅ GitHub Action or one API call |
| PR comment with breaking changes | ❌ | ✅ GitHub Action (Team) |
| Spec validation | ⚠️ Blueprint parser | ✅ Validator with line numbers and hints |
| Private docs | ⚠️ Legacy plans | ✅ Password or magic link (Team) |
| Price | No new paid plans; service ends 2026-10-31 | Free Starter / $19 per month Team, flat |
Apiary status per the Oracle end-of-life announcement as reported in October 2026. Apiary cells are approximate because the product is in maintenance mode. Verified October 2026.
Apiary stops working entirely after October 31, 2026, and remaining instances are deleted. Anything you have not exported by then is gone.
ApiNotes is actively developed and priced openly. Your published docs stay on your own domain, and your spec lives in your repo.
Apiary documents are written in API Blueprint, a Markdown-flavoured format that most modern tooling no longer targets.
ApiNotes reads OpenAPI 3.0, 3.1, 3.2 and Swagger 2.0. Convert your Blueprint with a community converter such as apib2swagger or the API Elements tools, check the output with the validator, then publish it.
Apiary's mock server ends with the rest of the service on October 31, 2026.
Once your spec is OpenAPI you can create a hosted mock server from it.
A frozen product with no new development.
Version history, an automatic changelog, breaking-change detection, subscriber emails and a GitHub Action, which Apiary never offered.
Apiary's paid plans were discontinued in 2018 and the service ends on October 31, 2026.
Starter, $0: 1 public API, hosted docs, changelog for the last 10 releases, breaking-change detection, 25 subscribers, GitHub Action, Try-it panel. Team, $19/month flat: 5 APIs, full changelog history, unlimited subscribers, PR comments, private docs, 25 guest readers, custom domain, your own branding, 5 team members. 14-day trial, no card needed.
Paste the same OpenAPI file you use today. Hosted docs, a changelog and breaking-change alerts are live in under a minute.