vagrant/website/source/docs/vagrant-cloud/boxes/release-workflow.html.md

layout	page_title	sidebar_current
vagrant-cloud	API Release Workflow	vagrant-cloud-boxes-release-workflow

API Release Workflow

Creating new boxes through their release lifecycle is possible through the Vagrant Cloud website, but you can also automate the task via the Vagrant Cloud API.

1. Create box, or locate a boxes tag, like hashicorp/precise64
2. After some event, like the end of a CI build, you may want to release a new version of the box. To do this, first use the API to create a new version with a version number and a short description of the changes
3. Then, create any providers associated with the version, like virtualbox
4. Once your system has made the necessary requests to the API and the version is ready, make a request to the release endpoint on the version
5. The version should now be available to users of the box via the command vagrant box outdated or via the automated checks on vagrant up