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

# API Release Workflow

Creating new boxes through their [release lifecycle](/docs/vagrant-cloud/boxes/lifecycle.html)
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/bionic64`
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`