How to Reset or Complete a Stuck Optimizely DXP Integration Deployment using the Optimizely Deployment API

If you’ve deployed to Optimizely’s Integration environment without specifying the DirectDeploy parameter in your PowerShell command, your deployment might get stuck in an “AwaitingVerification” state.

Without a record of the deployment ID, the deployment pipeline can become blocked. Unlike Pre-Production or Production environments, the Optimizely PaaS portal does not offer a UI option to reset or complete Integration deployments.

Here’s how to resolve this issue quickly using PowerShell:

1. Connect to Optimizley Deployment API

Run the following command, replacing placeholders with your credentials:

Connect-EpiCloud -ClientKey <ClientKey> -ClientSecret <ClientSecret> -ProjectId <ProjectId>
2. Find the Deployment ID

Identify deployments stuck in AwaitingVerification:

Get-EpiDeployment | Where-Object { $_.Status -notin @("Succeeded", "Failed", "Redeployed") }

You’ll see output similar to:

id               : 36d74dbe-75b5-4037-b2f2-426b6c906982
projectId        : ce447ee1-de47-450d-801e-aacae4fdc24e
status           : AwaitingVerification
startTime        : 2025-03-27T12:49:35.451Z
percentComplete  : 100
3. Find the Deployment ID

Choose one:

To Reset the deployment:

Reset-EpiDeployment -Id <DeploymentId> -Wait

To Complete the deployment:

Complete-EpiDeployment -Id <DeploymentId> -Wait

Replace <DeploymentId> with the actual deployment ID from the previous step.

Your Integration environment should now be unblocked and ready for new deployments.

Leave a comment