# Disabling or enabling a process flow deployment for a virtual environment

## Introduction

If you need to temporarily prevent a deployed process flow from running in a virtual environment, you can [disable](#disabling-a-flow-deployment-for-a-virtual-environment) it, then [enable](#enabling-a-flow-deployment-for-a-virtual-environment) it again when you're ready. For example, if your third-party system experiences an outage, you may want to stop a flow running until the issue is resolved.&#x20;

{% hint style="info" %}
When a process flow version is deployed to a virtual environment (either [individually](https://doc.wearepatchworks.com/product-documentation/virtual-environments/implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment) or [as part of a package](https://doc.wearepatchworks.com/product-documentation/virtual-environments/virtual-environment-packages/managing-packages/deploying-a-package)), it is enabled automatically. The steps detailed on this page are only required if you need to disable a deployed process flow for any reason and then enable it again later.
{% endhint %}

{% hint style="warning" %}
If you do NOT use virtual environments, different instructions apply; please refer to [Enabling & disabling a process flow](https://doc.wearepatchworks.com/product-documentation/process-flows/managing-process-flows/enabling-and-disabling-a-process-flow/enabling-and-disabling-a-process-flow-without-virtual-enviroments).
{% endhint %}

## Disabling a flow deployment for a virtual environment

When a process flow deployment is disabled for a virtual environment, the flow stops being initialised in that environment (keep in mind that you're disabling a *deployment* of a flow, not the flow itself - any deployments of this flow in other virtual environments will be unaffected).&#x20;

There are two ways to disable a flow deployment for a virtual environment:

* [Via the process flow canvas](#disabling-a-process-flow-deployment-from-the-canvas)
* [Via the virtual environment](#disabling-a-process-flow-deployment-from-the-virtual-environment)

### Disabling a process flow deployment from the canvas

{% stepper %}
{% step %}
**Access the required process flow**

[Access the process flow version](https://doc.wearepatchworks.com/product-documentation/process-flows/accessing-your-process-flows) that you want to disable (it doesn't matter which version is displayed on the canvas).
{% endstep %}

{% step %}
**Access process flow settings**

Select `flow settings` from the actions bar - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRnROyM7gHTrgp8fjepMs%2Fdisable%20via%20canvas%201.png?alt=media&#x26;token=805403ec-f96f-4cc9-8841-829592b46022" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**View deployments for this process flow**

Click the `view deployments` button:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FVpbuyODCyarEdKcZREWU%2Fdisable%20via%20canvas%202.png?alt=media&#x26;token=391a7263-1a83-4fa3-9ba7-07e67823f7ce" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Access deployment options**

Click the ellipsis icon associated with the deployment that you want to disable - for example:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FTcY8lIo5GG47YvBz6HKw%2Fdisable%20via%20canvas%202a.png?alt=media&#x26;token=e06868de-9e19-4d3f-8ce0-5f169f79b07b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Disable the flow deployment**

Select the `disable` option:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FUdwT3T0UeaY21tV3DvZv%2Fdisable%20via%20canvas%203.png?alt=media&#x26;token=73698fac-47c4-430a-82c3-b057defcf32d" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Disabling a process flow deployment from the virtual environment

{% stepper %}
{% step %}
**Access virtual environments**

[Log in to the dashboard](https://app.wearepatchworks.com/virtual-environments) and select `virtual environments` | `overview` from the left-hand navigation menu.
{% endstep %}

{% step %}
**Select the required virtual environment**

Click the name associated with the virtual environment that you want to access - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F4wjPIxpvvo4GLZFGUgDu%2Fdisable%20via%20ve%201.png?alt=media&#x26;token=3f2c519d-9aee-4664-9808-f47baa830157" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Access deployment options**

Click the ellipsis icon associated with the deployment that you want to disable - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F2525s2aiAIuUc6kQXKDj%2Fdisable%20via%20ve%202.png?alt=media&#x26;token=ae3a8904-b127-4f30-8117-2c57a2329ef4" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Disable the flow deployment**

Select the `disable` option:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FJ1rvRjgkrRzhAikSRm4t%2Fdisable%20via%20ve%203.png?alt=media&#x26;token=28f442fb-b33e-4450-acb3-7b7b9160f75c" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Enabling a flow deployment for a virtual environment

When a process flow is enabled for a virtual environment, it will be initialised in that environment (as per any defined [triggers](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/trigger-shape) or [API calls](https://doc.wearepatchworks.com/product-documentation/virtual-environments/managing-virtual-environments-versions-and-flows/managing-virtual-environment-flow-deployments/broken-reference)). There are two ways to enable a flow deployment for a virtual environment:

* [Via the process flow canvas](#enabling-a-process-flow-deployment-from-the-canvas)
* [Via the virtual environment](#enabling-a-process-flow-deployment-from-the-virtual-environment)

### Enabling a process flow deployment from the canvas

{% stepper %}
{% step %}
**Access the required process flow**

[Access the process flow version](https://doc.wearepatchworks.com/product-documentation/process-flows/accessing-your-process-flows) that you want to enable (it doesn't matter which version is displayed on the canvas).
{% endstep %}

{% step %}
**Access process flow settings**

Select `flow settings` from the actions bar - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRnROyM7gHTrgp8fjepMs%2Fdisable%20via%20canvas%201.png?alt=media&#x26;token=805403ec-f96f-4cc9-8841-829592b46022" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**View deployments for this process flow**

Click the `view deployments` button:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fi6V7EQkGwzOVXriDxb6i%2Fenable%20via%20canvas%200.png?alt=media&#x26;token=7c18ecce-aaaa-49f1-b5f3-3b4b216bf34b" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Access deployment options**

Click the ellipsis icon associated with the deployment that you want to enable - for example:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FknYfvgjZipTBU8uPklAB%2Fenable%20via%20canvas%202a.png?alt=media&#x26;token=35722884-7010-46c0-bde9-32c7437b6336" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Enable the flow deployment**

Select the `enable` option:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F0WE2Hjkc5TVUkUUaRjDW%2Fenable%20via%20canvas%203.png?alt=media&#x26;token=72b5ef27-5b3c-4bce-8615-f8685051bd6e" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Enabling a process flow deployment from the virtual environment

{% stepper %}
{% step %}
**Access virtual environments**

[Log in to the dashboard](https://app.wearepatchworks.com/virtual-environments) and select `virtual environments` | `overview` from the left-hand navigation menu.
{% endstep %}

{% step %}
**Select the required virtual environment**

Click the name associated with the virtual environment that you want to access - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F4wjPIxpvvo4GLZFGUgDu%2Fdisable%20via%20ve%201.png?alt=media&#x26;token=3f2c519d-9aee-4664-9808-f47baa830157" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Access deployment options**

Click the ellipsis icon associated with the deployment that you want to enable - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FSNPNCw1e2mzh4rl00cZx%2Fenable%20via%20ve%202.png?alt=media&#x26;token=709e1a66-b645-4116-8f11-7757ea1254d3" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Enable the flow deployment**

Select the `enable` option:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F42cdHI2W7FYikmuF4Czg%2Fenable%20via%20ve%203.png?alt=media&#x26;token=71351a4b-61c2-4a65-b29d-4f5a29deccaf" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# 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/managing-virtual-environments-versions-and-flows/managing-virtual-environment-flow-deployments/disabling-or-enabling-a-process-flow-deployment-for-a-virtual-environment.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.
