Go to Navigation
Back to Articles

Interact with Apiary from the Command Line

By Stephen Mizell (Stephen_Mizell, stephen@apiary.io) on 05 Nov 2014

We thought we’d put together a blog post to highlight another way for you to work with Apiary, and that is through using our Apiary CLI tool. Everyone has their own workflow, and sometimes that workflow involves their favorite editor and the command line. This Apiary CLI tool can allow you to stay in that workflow while interacting directly with Apiary through our API.

Previewing Locally

With the Apiary CLI tool, you can preview what your API Blueprint would look like on Apiary while working in your favorite editor.

apiary preview --server

By default, this is going to be looking in the current directory for an API Blueprint file named apiary.apib, which can be changed with the --path flag. Every refresh of the page will send your API Blueprint to Apiary to be rendered and sent back to you.

This is great for allowing Apiary to be part of your current workflow without requiring you to use our editor, and since you see exactly what we generate, you know your changes will be right when you publish them.

Fetching from Apiary

To make this work even better with your workflow, you can also fetch and publish your API Blueprints. If you have existing documentation at Apiary, you can easily grab that document for developing and previewing locally.

apiary fetch --api-name=API_NAME

This command grabs the published documentation and saves it as apiary.apib.

Publishing to Apiary

Once you’ve made your changes and previewed how they look locally, you can publish those changes directly to Apiary with another simple command.

apiary publish --api-name=API_NAME

No need to copy and paste to Apiary–just publish your changes and keep working.


The goal with this is to make your life easier by providing tools that can fit directly into your workflow. The Apiary CLI tool is open source, and we are always interested in pull requests. Additionally, if you have any thoughts on ways to make this tool even better, please let us know!