Start Pipeline API Endpoint

The following documentation explains how to use an API call with Opsera’s new API endpoint to trigger a pipeline start with an Approval Gate step then approve the pipeline step via Microsoft Teams. The Approval Gate step must be set up with a Step Notification configured to a MS Teams tool.

Pipeline Step Setup

Approval Gate Step

You must use an Approval Gate step for this step. This step must be the FIRST step in the pipeline workflow. Use the following instructions to set up an Approval Gate Step.

1. In pipeline workflow, create a new step.

2. In Step Setup, select Approval Gate from the Tool dropdown.

   

3. Click the ‘Save' button and exit Step Setup.

4. Select the gear icon to configure the Approval Gate step.

   

5. In the Step Configuration form, enable the Send Custom Message toggle. Provide a Custom Step Message and Point of Contact.
   
   Note: The Custom Step Message will be overwritten by the API call Notification Message.
   

   

6. Click the ‘Save’ button and close out of the step.
   

Step Notification Setup

1. Once the Approval Gate step has been configured, click the mail icon on the step to open the Pipeline Step Notification Configuration.

   

2. Select Microsoft Teams.

3. Enable the Teams Notification toggle.

4. Select Notification Level from dropdown.

5. Select the configured Teams Tool from the dropdown.

   

6. Click the ‘Save’ button and exit.

Retrieving Pipeline ID and Step ID for API Request

1. Your Pipeline ID can be found in various locations, such as in the URL of your pipeline or the Summary panel.

   

2. The Step ID from the Approval Gate Step can be found directly on the pipeline step.

   

Now that you have a Personal Access Token, Approval Gate Step, Pipeline ID and Step ID, you can make the API call.

API Request

Use the following information for method, URL, endpoint and body. Verify that the user making the API call has RBAC to the specific pipeline.

{
    "pipelineId":"[insert pipeline id]",
    "stepId": "[insert step id]",
    "notificationMessage":"here is the custom message"
}

Approve Pipeline Start in MS Teams

1. Once you receive the Pipeline Notification via MS Teams, verify the information and click the ‘Approve’ button.

   

2. Once you approve the Pipeline Notification, the pipeline will start.