# Reviewing version information for  virtual environment process flows

## Introduction

When reviewing version information for a process flow that's deployed to virtual environments, there are two levels to consider:

* [Process flow version information](#the-process-flow-versions-panel)
* [Deployment information](#the-view-deployments-modal)

## The process flow versions panel

The versions panel is available in [process flow settings](/product-documentation/process-flows/building-process-flows/process-flow-settings.md) - for example:

<figure><img src="/files/7EEAYBNy5HAC2ocWmfkC" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
To access this information, open the required process flow, access [process flow settings](/product-documentation/process-flows/building-process-flows/process-flow-settings.md),  then scroll down to the `versions` panel.
{% endhint %}

From here, you can see the following details for each *version*:

<table><thead><tr><th width="246.2109375">Heading</th><th>Summary</th></tr></thead><tbody><tr><td>#</td><td>The flow version number. The version number remains constant unless another version is deleted, in which case any remaining version numbers update accordingly.</td></tr><tr><td>ID</td><td>The unique identifier associated with a version. This identifier remains constant, even if the original version number changes as a consequence of <a href="#version-options">another version being deleted</a>. <br><br>If you are using our API to work with virtual environments, you'll need this <code>id</code> to target the required flow version.</td></tr><tr><td>Created</td><td>The date and time (UTC) this version was created.</td></tr><tr><td>Updated</td><td>The date and time (UTC) this version was updated.</td></tr><tr><td>Status</td><td><p>The current status of this version. Each new version of a process flow starts as a <code>draft</code>, and increments the version number. The version then progresses through its own <a href="/pages/JfIV5L8UTupZFmUOTxgL">lifecycle</a>. <br><br>It's important to remember that a single flow version can be deployed to multiple virtual environments. So:<br></p><ul><li>If a flow version shows as <code>deployed</code> here, then it is currently deployed to <em>at least</em> one virtual environment (or to no virtual environment).</li><li>If a flow version shows as <code>inactive</code> here, then it has been disabled in/deleted from all virtual environments where it was previously deployed. </li></ul><p>With this in mind, you'll likely want to view deployment activity for each version at a more granular level. You can do this within <a href="#the-view-deployments-page">view deployments</a>.</p></td></tr><tr><td>...</td><td>Access <a href="#version-options">options to work with the selected version</a>.</td></tr></tbody></table>

### Version options

The ellipsis associated with each version provides access to the following options (availability varies, depending on the [version status](/product-documentation/virtual-environments/implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment/understanding-flow-versioning-for-virtual-environments.md)):

<table><thead><tr><th width="198.3359375">Option</th><th>Applicable from status...<select multiple><option value="NYQEX25HHYWG" label="draft" color="blue"></option><option value="YMhkJCk0rBUW" label="inactive" color="blue"></option><option value="r4OOuW1b4nN4" label="deployed" color="blue"></option></select></th><th>Summary</th></tr></thead><tbody><tr><td>Duplicate flow</td><td><span data-option="NYQEX25HHYWG">draft, </span><span data-option="r4OOuW1b4nN4">deployed, </span><span data-option="YMhkJCk0rBUW">inactive</span></td><td>Copy the selected flow version to a new process flow.</td></tr><tr><td>Copy to draft</td><td><span data-option="r4OOuW1b4nN4">deployed, </span><span data-option="YMhkJCk0rBUW">inactive</span></td><td>Overwrite the existing draft version with content from the selected flow version.</td></tr><tr><td>Upload to marketplace</td><td><span data-option="r4OOuW1b4nN4">deployed</span></td><td>Upload the selected version to your <a href="/pages/Yh6SKOPDHxyeAAMVa7BT">private marketplace</a> (only applicable if the <a href="/pages/5JzXXY339CKzG84bKWYR#about-the-partner-features-bolt-on">partner features bolt-on</a> is enabled for your company profile).</td></tr><tr><td>Delete</td><td><span data-option="YMhkJCk0rBUW">inactive</span></td><td>Deletes the selected version entirely, including from any associated <a href="/pages/SiWXnE8YVuWBDKUA7NFW">virtual environments</a> and <a href="/pages/pjuTdsXxhleufN4kXRGJ">packages</a>. Remaining version numbers are re-sequenced accordingly.</td></tr></tbody></table>

## The view deployments page

Each time a process flow version is [deployed](/product-documentation/virtual-environments/implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment.md) to any (or no) environment, an entry is added to the `view deployments` page for that flow - for example:

<figure><img src="/files/c4nbvg5Q4ki7d3chUZnj" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
To access this information, open the required process flow, access [process flow settings](/product-documentation/process-flows/building-process-flows/process-flow-settings.md), and then click `view deployments`:<br>

![](/files/IbDkPC3WTEMP34qRMx2R)
{% endhint %}

From here, you can see the following details for each deployment:

<table><thead><tr><th width="246.2109375">Heading</th><th>Summary</th></tr></thead><tbody><tr><td>Virtual environment</td><td>The name of the virtual environment selected for this deployment. This is appended with the environment <code>type</code> (either <code>test</code> or <code>live</code>).</td></tr><tr><td>Version</td><td>The process flow version number selected for this deployment. This is appended with the version <code>id</code> (a unique identifier for the version, which is needed if you're working with virtual environments via the API).</td></tr><tr><td>Enabled at</td><td>The date and time (UTC) that this deployment was made, appended with the username of the person who completed this operation.</td></tr><tr><td>Queue priority</td><td>The <a href="/pages/syu5QGJS98qkeixeUPJN">queue priority</a> selected for this deployment.</td></tr><tr><td>Package</td><td>If a flow version was deployed via a <a href="/pages/pjuTdsXxhleufN4kXRGJ">package</a>, the package name is shown.</td></tr><tr><td>...</td><td>Access <a href="#virtual-environment-deployment-options">options to work with the selected deployment</a>.</td></tr></tbody></table>

{% hint style="info" %}
If you want to see all flow deployments across all flows and virtual environments, you can view the [current flow deployments page](/product-documentation/virtual-environments/managing-virtual-environments-versions-and-flows/managing-virtual-environment-flow-deployments/viewing-flow-deployments.md).
{% endhint %}

### Virtual environment deployment options

The ellipsis associated with each deployment provides access to the following options:

<table><thead><tr><th width="198.3359375">Option</th><th>Summary</th></tr></thead><tbody><tr><td>Edit</td><td>Use this as a shortcut if you want to deploy a given version again, with similar settings. This populates the <code>virtual envrionment</code>, <code>flow version</code>, and <code>queue priority</code> fields with selections used in the given deployment. From here you can change the  <code>virtual envrionment</code> and/or <code>queue priority</code> fields, then deploy the given version again. </td></tr><tr><td>Disable / Enable</td><td><p>Availability depends on whether the selected deployment is currently <a href="/pages/S7ZXvG3q7xvcFezsI1dS">enabled or disabled</a>, so you set the reverse state. Note that: <br></p><ul><li>If a deployment is <code>enabled</code>, it will run in the associated virtual environment.</li><li>If a deployment is <code>disabled</code>, it will NOT run in the associated virtual environment.</li></ul></td></tr><tr><td>Delete</td><td>Delete the selected deployment. This removes the flow version from the associated virtual environment and sets the status to <code>inactive</code>.</td></tr></tbody></table>

### Deploying & disabling a process flow

By default, a flow version is deployed and `enabled`, which means it runs according to any defined trigger settings immediately (i.e. it's 'live'). If you aren't ready for a deployment to be live, you can use the `disable flow` option:

<div align="left"><figure><img src="/files/QzyY1BVnnu0bpsjf5Ji1" alt=""><figcaption></figcaption></figure></div>

In this case, the process flow is deployed to the selected environment, but it won't run automatically.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/virtual-environments/implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment/understanding-flow-versioning-for-virtual-environments/reviewing-version-information-for-virtual-environment-process-flows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
