completeApprovalGate

This POST service will approve or reject an Approval Gate for a pipeline stage execution. 

The pipeline execution for the release is located by using the given snapshotName, or the most recent snapshot if not provided.  The pipeline stage execution from within the pipeline execution is determined by finding the latest execution for the given environmentCode and gateName.  An error will be returned if the stage executing in not currently in the gates or if the gateName provided is not pending an approval.

API URL

http://host:port/flexdeploy/rest/release/completeApprovalGate

The authenticated user must be a member of the pipeline role assigned to gate in order to approve or reject it.

Complete Approval Gate Sample JSON Request


{

"authentication": { "userId":"fdadmin", "password":"password1" },

Opening bracket

Authentication section, used on all types of requests.

Required parameters for creating or editing a release.

"releaseName": "Demo Release",

"gateName": "MyApprovalGate",

"environmentCode": "DEV",

"status": "APPROVED",

Complete the gate on the release named Demo Release

The Gate we want to complete is named "MyApprovalGate".

The gate we're approving is in the DEV Environment.

The Status to give to the gate. Options are [APPROVED, REJECTED]

Optionally, include any of this information.

Verify that your JSON is valid; check for trailing commas if you don't include this section.

"snapshotName": "09-24-2017 14:26:47"The name of the Snapshot we want to approve is "09-24-2017 14:26:47". If this is not specified, FlexDeploy will use the latest running snapshot.
}Closing bracket

Parameters

Parameter

Required

Type

Description

authentication

Y

Object

The login information for the user connecting to FlexDeploy.

releaseName

Y

String

The name of the release containing the gate we want to complete.

gateName

Y

String

The name of the gate to update the status on.

snapshotName

N

String

The name of the executing snapshot that is waiting on the gate. If not provided, latest Stage Execution will be used.

environmentCode

Y

String

The code for the environment the gate is executing in.

status

Y

String

The updated status to apply to the gate. Options are [APPROVED, REJECTED]

Example Request

{
   "authentication": 
    {
       "userId": "fdadmin",
       "password": "welcome1"
    },
   "releaseName": "Release 3",
   "environmentCode": "TEST",
   "gateName": "Manager Approval",
   "status" : "APPROVED"
}


The following macros are not currently supported in the footer:
  • style