All Event messages have the following top level fields:

Key	Description
eventType	The event type that triggered this Event. e.g. Workflow Completed, Task Created.
actor	The actor, generally a user, that triggered this event.
object	The object the event occurred on. This could be the Project name, Release name etc.
timestamp	The time the event occurred.
payload	The specific event payload (see examples below)

Events

...

Comment Added

The Pipeline Stage Completed Comment Added event is triggered whenever a stage succeeds or fails in a Release Pipeline Execution. Common use cases can include logic you want to perform after EVERY pipeline execution regardless of the Pipeline or Release being used. For example you may want to create a Service Now incident whenever the Production Stage fails in any pipeline. This could be easily accomplished by listening for this event but filtering for a status of FAILED and environment of PRODUCTION.

...

language	json

...

anytime there is a comment created throughout FlexDeploy. As and example use case, you could use this event to create a Jira Ticket anytime a comment was created and contained the words “Jira”.

Code Block

{
  "eventType": "Comment Added",
  "actor": "fdadmin",
  "object": "Comment - 1913",
  "timestamp": "2023-10-18 05:45:44 -0500",
  "payload": {
    "createdBy": "fdadmin",
    "createdOn": "2023-10-18 05:45:44 -0500",
    "updatedBy": "fdadmin",
    "updatedOn": "2023-10-18 05:45:44 -0500",
    "commentId": 1913,
    "oldCommentText": null,
    "commentText": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"test4\"}]}]}",
    "objectId": 33313,
    "objectType": "WORK_ITEM"
  }
}

Comment Updated

The Comment Updated event is triggered anytime a comment is edited throughout FlexDeploy.

Code Block

{
  "eventType": "Comment Updated",
  "actor": "fdadmin",
  "object": "Comment - 1913",
  "timestamp": "2023-10-18 05:45:44 -0500",
  "payload": {
    "createdBy": "fdadmin",
    "createdOn": "2023-10-18 05:45:44 -0500",
    "updatedBy": "fdadmin",
    "updatedOn": "2023-10-18 05:45:44 -0500",
    "commentId": 1913,
    "oldCommentText": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"test3\"}]}]}",
    "commentText": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"test4\"}]}]}",
    "objectId": 33313,
    "objectType": "WORK_ITEM"
  }
}

Comment Deleted

The Comment Updated event is triggered anytime a comment is deleted throughout FlexDeploy.

Code Block

{
  "eventType": "Comment Updated",
  "actor": "fdadmin",
  "object": "Comment - 1913",
  "timestamp": "2023-10-18 05:45:44 -0500",
  "payload": {
    "createdBy": "fdadmin",
    "createdOn": "2023-10-18 05:45:44 -0500",
    "updatedBy": "fdadmin",
    "updatedOn": "2023-10-18 05:45:44 -0500",
    "commentId": 1913,
    "oldCommentText": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"test3\"}]}]}",
    "commentText": null,
    "objectId": 33313,
    "objectType": "WORK_ITEM"
  }
}

Package Created

The Package Created event is triggered anytime a package is created for a project throughout FlexDeploy. This could possibly be used as a event to execute a script to automatically add the package to a release whenever one is created for a specific project.

Code Block

{
  "eventType": "Package Created",
  "actor": "fdadmin",
  "object": "XXHR-10089",
  "timestamp": "2023-10-19 12:52:11 -0500",
  "payload": {
    "createdBy": "fdadmin",
    "createdOn": "2023-10-19 12:52:11 -0500",
    "updatedBy": "fdadmin",
    "updatedOn": "2023-10-19 12:52:11 -0500",
    "projectPackageId": 1144126,
    "description": "\n",
    "excludePath": null,
    "includePath": null,
    "packageName": "XXHR-10089",
    "packagePath": null,
    "packageStatus": "ACTIVE",
    "packageType": "USER_MANAGED",
    "projectId": 195743,
    "tests": null,
    "testLevel": null,
    "versionSyntax": null,
    "project": {
      "projectId": 195743,
      "projectName": "XXHR"
    }
  }
}

Package Status Updated

@Since 7.0.0.1 - The Package Status Updated event is triggered anytime a package’s status is changed (‘Active’, ‘Inactive’, ‘Completed’) for a project throughout FlexDeploy. This could possibly be used as a event to execute a script to automatically remove the package from a release whenever it is inactivated or completed for a specific project.

Code Block

{
  "eventType": "Package Status Updated",
  "actor": "fdadmin",
  "object": "XXHR-10089",
  "timestamp": "2023-10-19 12:52:11 -0500",
  "payload": {
    "createdBy": "fdadmin",
    "createdOn": "2023-10-19 12:52:11 -0500",
    "updatedBy": "fdadmin",
    "updatedOn": "2023-10-19 12:52:11 -0500",
    "projectPackageId": 1144126,
    "description": "\n",
    "excludePath": null,
    "includePath": null,
    "packageName": "XXHR-10089",
    "packagePath": null,
    "packageStatus": "ACTIVE",
    "packageType": "USER_MANAGED",
    "projectId": 195743,
    "tests": null,
    "testLevel": null,
    "versionSyntax": null,
    "project": {
      "projectId": 195743,
      "projectName": "XXHR"
    }
  }
}

Pipeline Stage Completed

The Pipeline Stage Completed event is triggered whenever a stage succeeds or fails in a Release Pipeline Execution. Common use cases can include logic you want to perform after EVERY pipeline execution regardless of the Pipeline or Release being used. For example you may want to create a Service Now incident whenever the Production Stage fails in any pipeline. This could be easily accomplished by listening for this event but filtering for a status of FAILED and environment of PRODUCTION.

Code Block

language	json

{
    "eventType":"Pipeline Stage Completed",
    "actor":"buildmonitorworker",
    "object":"REST Release 1",
    "timestamp":"2020-12-16 15:12:41 -0500",
    "payload":{
        "pipelineExecutionId":null,
        "pipelineStageExecution":{
            "stageExecutionId":104516,
            "environmentId":11595,
            "executionStatus":"FAILED",
            "startTime":"2020-12-16 15:12:19 -0500",
            "endTime":"2020-12-16 15:12:41 -0500",
            "activeStep":null
        },
        "pipeline":{
            "pipelineId":10001,
            "pipelineName":"Simple"
        },
        "environment":{
            "environmentId":11595,
            "environmentName":"Dev",
            "environmentCode":"DEV"
        },
        "release":{
            "releaseId":11611,
            "releaseName":"REST Release 1"
        },
        "snapshot":{
            "snapshotId":104506,
            "snapshotName":"07-16-2020 15:12:18",
            "snapshotStatus":"INITIATED",
            "description":null,
            "releaseId":11611
        }
    }
}

Release Started

The Release Started event is triggered whenever a release is started in FlexDeploy. Common use cases can include logic you want to perform after any release is started. For example you may want to start a sprint in Jira whenever the release is started.

Code Block

language	json

{
  "eventType": "Release Started",
  "actor": "avnish",
  "object": "Release Build 503",
  "timestamp": "2024-03-25 13:17:08 -0500",
  "payload": {
    "release": {
      "releaseId": 236634,
      "releaseName": "Release Build 503",
      "releaseDescription": "Blackout W test"
    },
    "startDate": 1711390628000,
    "endDate": null,
    "projects": [
      {
        "projectId": 10212437,
        "projectName": "XXHR",
        "packageName": "JavaPkg",
        "streamName": "master",
        "buildEnvironment": {
          "environmentId": 11595,
          "environmentName": "Dev123",
          "environmentCode": "DEV1"
        },
        "groupName": null
      },
      {
        "projectId": 19422906,
        "projectName": "Build 503",
        "packageName": null,
        "streamName": "master",
        "buildEnvironment": {
          "environmentId": 223477,
          "environmentName": "503 Build",
          "environmentCode": "503BUILD"
        },
        "groupName": null
      },
      {
        "projectId": 19667075,
        "projectName": "XXHR TFVC",
        "packageName": "Pkg1",
        "streamName": "master",
        "buildEnvironment": {
          "environmentId": 418564,
          "environmentName": "Development",
          "environmentCode": "DEV"
        },
        "groupName": null
      }
    ],
    "pipeline": {
      "pipelineId": 198497,
      "pipelineName": "Pipeline Check"
    }
  }
}

Release Ended

The Release Ended event is triggered whenever a release is endedin FlexDeploy. Common use cases can include logic you want to perform after any release is ended. For example you may want to end a sprint in Jira whenever the release is ended.

Code Block

language	json

{
  "eventType": "Release Ended",
  "actor": "avnish",
  "object": "Release Build 503",
  "timestamp": "2024-03-25 13:19:00 -0500",
  "payload": {
    "release": {
      "releaseId": 236634,
      "releaseName": "Release Build 503",
      "releaseDescription": "Blackout W test"
    },
    "startDate": 1711390628000,
    "endDate": null,
    "projects": [
      {
        "projectId": 10212437,
        "projectName": "XXHR",
        "packageName": "JavaPkg",
        "streamName": "master",
        "buildEnvironment": {
          "environmentId": 11595,
          "environmentName": "Dev123",
          "environmentCode": "DEV1"
        },
        "groupName": null
      },
      {
        "projectId": 19422906,
        "projectName": "Build 503",
        "packageName": null,
        "streamName": "master",
        "buildEnvironment": {
          "environmentId": 223477,
          "environmentName": "503 Build",
          "environmentCode": "503BUILD"
        },
        "groupName": null
      },
      {
        "projectId": 19667075,
        "projectName": "XXHR TFVC",
        "packageName": "Pkg1",
        "streamName": "master",
        "buildEnvironment": {
          "environmentId": 418564,
          "environmentName": "Development",
          "environmentCode": "DEV"
        },
        "groupName": null
      }
    ],
    "pipeline": {
      "pipelineId": 198497,
      "pipelineName": "Pipeline Check"
    }
  }
}

Snapshot Completed

The Snapshot Completed event is triggered whenever a snapshot eventually completes successfully or fails to build.

Code Block

language	json

{
    "eventType":"Snapshot Completed",
    "actor":"fdadmin",
    "object":"07-16-2020 15:58:59",
    "timestamp":null,
    "payload":{
        "createdBy":"fdadmin",
        "createdOn":"2020-58-16 15:58:57 -0500",
        "updatedBy":"completedsnapshotsmonitor",
        "updatedOn":"2020-59-16 15:59:13 -0500",
        "snapshot":{
            "snapshotId":104530,
            "snapshotName":"07-16-2020 15:58:59",
            "snapshotStatus":"INITIATED",
            "description":null,
            "releaseId":50157
        }
    }
}

Tag Assigned

The Tag Assigned event is triggered whenever a tag is assigned to an object like a project, environment, or target group.

Code Block

{
  "eventType": "Tag Assigned",
  "actor": "fdadmin",
  "object": "alpha",
  "timestamp": "2023-10-19 12:53:12 -0500",
  "payload": {
    "createdBy": "fdadmin",
    "createdOn": "2023-10-19 12:53:12 -0500",
    "updatedBy": "fdadmin",
    "updatedOn": "2023-10-19 12:53:12 -0500",
    "payloadtagAssignmentId": 135344,
    "tagId": 64158,
    "tag": {
      "tagId": 64158,
         "pipelineExecutionId":null,
  "tagStyle": "{\"dark\":\"#949FDA\",\"light\":\"#3F51B5\"}",
      "pipelineStageExecutiontagKey":{ "alpha"
    },
      "stageExecutionIdobjectId":104516 557168,
    "objectType": "TARGET_GROUP"
  }
}

Tag Unassigned

The Tag Unassigned event is triggered whenever a tag is unassigned from an object like a project, environment, or target group.

Code Block

{
  "environmentIdeventType":11595, "Tag Unassigned",
     "actor": "fdadmin",
    "executionStatusobject": "FAILEDalpha",
      
     "startTimetimestamp": "20202023-1210-1619 1512:1253:1923 -0500",
  "payload": {
    "createdBy": "fdadmin",
    "endTimecreatedOn": "20202023-1210-1619 1512:53:12:41 -0500",
      "updatedBy": "fdadmin",
     "activeStepupdatedOn":null "2023-10-19        },
  12:53:12 -0500",
     "pipelinetagAssignmentId":{
        135344,
    "pipelineIdtagId":10001,
        64158,
    "pipelineName":"Simpletag": {
      "tagId": }64158,
        "environment":{"tagStyle": "{\"dark\":\"#949FDA\",\"light\":\"#3F51B5\"}",
      "tagKey": "alpha"
    "environmentId":11595},
      "objectId": 557168,
     "environmentNameobjectType": "DevTARGET_GROUP",
       }
}

Task Created

The Task Created event is triggered whenever a human task is created. This can be triggered from either a standalone project or a release.

Code Block

language	json

{
    "environmentCodeeventType":"DEV"
        },
 Task Created",
      "releaseactor":{
            "releaseId":11611,
     "completedsnapshotsmonitor",
      "releaseNameobject":"RESTTest Release 1",
    "timestamp":"2020-03-16    },
   16:03:43 -0500",
    "snapshotpayload":{
   
        "snapshotIdcreatedBy":104506,
  "completedsnapshotsmonitor",
         "snapshotNamecreatedOn":"072020-03-16-2020 1516:12:1803:43 -0500",
   
        "snapshotStatusupdatedBy":"INITIATEDcompletedsnapshotsmonitor",
            "descriptionupdatedOn":null,
  "2020-03-16 16:03:43 -0500",
         "releaseIdtaskId":1161150702,
        "taskStatus":"PENDING",
  }     }
}

Release Started

The Release Started event is triggered whenever a release is started in FlexDeploy. Common use cases can include logic you want to perform after any release is started. For example you may want to start a sprint in Jira whenever the release is started.

Code Block

language	json

{ "externalId":null,
        "eventTypeexternalSystemId":"Release Started",null,
        "actorexternalSystemType":"fdadmin"null,
        "objecttaskNotes":"testRelease",null,
        "timestampgroupId":"2020-08-18 16:08:48 -0500",10942,
        "payloadroleId":{11601,
        "releaseenvironment":{
            "releaseIdenvironmentId":5405211595,
            "releaseNameenvironmentName":"testReleaseDev",
            "releaseDescriptionenvironmentCode":null"DEV"
        },
        "startDaterelease":"2020-09-18",{
            "endDatereleaseId":null50157,
         "projects":[   "releaseName":"Test Release"
        },
   {     "pipelineExecution":{
            "projectIdpipelineId":44013554957,
                "projectNamepipelineExecutionId":"partialFile"104553,
                "streamNameexecutionStatus":"masterRUNNING",
   
            "buildEnvironmentactiveStageExecution":{
   
                "environmentIdstageExecutionId":null104554,
   
                "environmentNameenvironmentId":null11595,
                    "environmentCodeexecutionStatus":null"RUNNING_GATES",
                }"startTime":null,
                "groupNameendTime":null
            }
,
       ],         "pipelineactiveStep":{
    
       "pipelineId":17854,             "pipelineName":"DanPipeline"id":54961,
         }     } }

Release Ended

The Release Ended event is triggered whenever a release is endedin FlexDeploy. Common use cases can include logic you want to perform after any release is ended. For example you may want to end a sprint in Jira whenever the release is ended.

Code Block

language	json

{     "eventTypeexecutionId":"Release Ended",104555,
          "actor":"fdadmin",     "object":"testRelease",     "timestampexecutionStatus":"2020-10-18 16:10:55 -0500",PENDING_APPROVAL",
          "payload":{          "releaseisGate":{true
            "releaseId":54052,    }
        "releaseName":"testRelease",    }
        "releaseDescription":null},
        }"snapshotId":104549,
        "startDateworkflow":"2020-09-18"null,
        "endDateworkflowRequestId":null,
        "projectsproject":[
null
    }
}

Task Approved

The Task Approved event is triggered whenever a human approval task is approved.

Code Block

{
  "eventType": "Task Approved",
  "actor": "fdadmin",
  {
 "object": "Sample Release",
  "timestamp": "2023-10-19 12:54:42 -0500",
  "payload": {
    "projectIdcreatedBy":440135 "releaseeventprocessor",
    "createdOn": "2023-10-19 12:25:39 -0500",
        "projectNameupdatedBy": "partialFilefdadmin",
    "updatedOn": "2023-10-19 12:54:42 -0500",
    "taskId": 274103,
    "streamNametaskStatus": "masterAPPROVED",
           "taskIdentifier": "a4591136-d24d-4144-9006-27262070dee7",
    "buildEnvironmenttaskType":{ "APPROVAL",
    "externalId": null,
      "externalSystemId": null,
      "environmentIdexternalSystemType": null,
    "taskNotes": "",
        "groupId": 1,
     "environmentNameroleId":null 15901,
    "environment": {
      "environmentId": 10051,
      "environmentCodeenvironmentName":null "Dev",
          "environmentCode": "DEV"
    },
        "release": {
       "groupNamereleaseId":null 703416,
      "releaseName": "Sample Release",
  }    "releaseDescription": null
   ],    },
    "pipelinepipelineExecution": {

           "pipelineId":17854 702655,
      "pipelineExecutionId": 898155,
      "pipelineNameexecutionStatus": "DanPipelineRUNNING",
      "activeStageExecution": {
}     } }

Snapshot Completed

The Snapshot Completed event is triggered whenever a snapshot eventually completes successfully or fails to build.

Code Block

language	json

{
    "eventTypestageExecutionId":"Snapshot Completed"898157,
    "actor":"fdadmin",     "objectenvironmentId":"07-16-2020 15:58:59" 10051,
    "timestamp":null,    "executionStatus": "payload":{"RUNNING_GATES",
        "createdBystartTime":"fdadmin" null,
        "createdOnendTime":"2020-58-16 15:58:57 -0500" null,
        "updatedByactiveStep":"completedsnapshotsmonitor", {
          "updatedOnid":"2020-59-16 15:59:13 -0500", 706075,
          "snapshotexecutionId":{ 898158,
          "executionStatus": "snapshotIdPENDING_APPROVAL":104530,
 
          "snapshotNameisGate":"07-16-2020 15:58:59", true
        }
   "snapshotStatus":"INITIATED",   }
    },
    "descriptionsnapshotId":null 898150,
 
    "workflow": null,
    "releaseIdworkflowRequestId":50157 null,
       }"project": null
    }
}

Task

...

Rejected

The Task Created Rejected event is triggered whenever a human approval task is created. This can be triggered from either a standalone project/application or a release.

...

language	json

rejected.

Code Block

{
  "eventType": "Task Rejected",
  "actor": "fdadmin",
  "object": "Sample Release",
  "timestamp": "2023-10-19 12:54:44 -0500",
  "payload": {
    "eventTypecreatedBy": "Task Createdreleaseeventprocessor",
    "actorcreatedOn":"completedsnapshotsmonitor "2023-10-19 12:25:00 -0500",
    "objectupdatedBy": "Test Releasefdadmin",
    "timestampupdatedOn": "20202023-0310-1619 1612:0354:4344 -0500",
    "payloadtaskId":{ 274101,
    "taskStatus": "REJECTED",
    "createdBytaskIdentifier":"completedsnapshotsmonitor "774bc94f-12f5-46de-a0c3-907662745222",
    "taskType": "APPROVAL",
    "createdOnexternalId":"2020-03-16 16:03:43 -0500" null,
    "externalSystemId": null,
    "externalSystemType": null,
    "updatedBytaskNotes": "completedsnapshotsmonitor",
    "groupId": 1,
    "updatedOnroleId":"2020-03-16 16:03:43 -0500",
    15901,
    "taskIdenvironment":50702, {
       "taskStatusenvironmentId":"PENDING" 10051,
      "environmentName":  "externalIdDev":null,
       "environmentCode": "externalSystemIdDEV":null,
    },
    "externalSystemTyperelease":null,  {
      "taskNotesreleaseId":null 703416,
 
      "groupIdreleaseName":10942, "Sample Release",
      "roleIdreleaseDescription":11601, null
    },
    "environmentpipelineExecution": {
      "pipelineId": 702655,
      "environmentIdpipelineExecutionId":11595,
     898141,
       "environmentNameexecutionStatus": "DevRUNNING",
     
      "environmentCodeactiveStageExecution":"DEV" {
        "stageExecutionId": }898143,
        "releaseenvironmentId":{ 10051,
        "executionStatus":   "releaseIdRUNNING_GATES":50157,
   
        "releaseNamestartTime":"Test Release" null,
        "endTime": }null,
        "pipelineExecutionactiveStep": {
 
          "pipelineIdid":54957 706075,
 
          "pipelineExecutionIdexecutionId":104553 898144,
 
          "executionStatus": "RUNNINGPENDING_APPROVAL",
 
          "activeStageExecutionisGate":{ true
        }
      "stageExecutionId":104554,}
    },
    "snapshotId": 898134,
     "environmentIdworkflow":11595 null,
    "workflowRequestId": null,
    "project": null
  }
}

User Created

The User Created event is triggered whenever a user is created inside FlexDeploy. This could be particularly useful when configuring users in an Single Sign-On (SSO) Realm setup.

Code Block

{
  "executionStatuseventType":"RUNNING_GATES "User Created",
  "actor": "fdadmin",
           "object": "startTimemarge":null,
  "timestamp": "2023-10-19 12:57:41 -0500",
  "payload": {
    "createdBy":  "endTimefdadmin":null,
    "createdOn": "2023-10-19 12:57:41 -0500",
        "activeStepupdatedBy":{ "fdadmin",
    "updatedOn": "2023-10-19 12:57:41 -0500",
    "userId": 29191963,
    "email": "id":54961,
        large.marge@gmail.com",
    "firstName": "large",
     "executionIdisActive":104555 true,
    "lastName": "marge",
    "localUser": true,
        "executionStatususerName": "PENDING_APPROVALmarge",
             "loginFailedAttempts": null,
      "isGategroups":true [
      {
         }"groupId": 1,
        "groupName": "FD Administrators",
 }       "description": "Admin }Users",
        "snapshotIdisActive":104549 true,
        "workflowisAdminGroup":null, true
      }
"workflowRequestId":null,    ],
    "projectextGroups":null []
   }
}

Workflow Completed

The Workflow Completed event is triggered whenever a workflow execution succeeds or fails. Note that this event will trigger for ALL workflow types.

...

The Work Item Created event is triggered whenever a work item is created.

Code Block

language	json

{
    "eventType":"Work Item Created",
    "actor":"fdadmin",
    "object":"5903",
    "timestamp":"2023-05-26 18:19:38 -0500",
    "payload":{
        "createdBy":"fdadmin",
        "createdOn":"2023-05-26 18:19:38 -0500",
        "updatedBy":"fdadmin",
        "updatedOn":"2023-05-26 18:19:38 -0500",
        "flxWorkItemId":5903,
        "workItemNumber":"5903",
        "title":"POSTMAN_Test_FlxWorkItem_2",
        "description":"POSTMAN test FlxWorkitem 2",
        "type":{
            "name":"12345678901234567890123456789012345678901234567890",
            "code":"12345678901234567890123456789012345678901234567890"
        },
        "status":{
            "id":1,
            "name":"TODO"
        },
        "assignee":{
            "id":1,
            "userName":"fdadmin",
            "email":"erick.jones@flexagon.com"
        },
        "tags":null,
        "customFields":[
        ],
        "workItemUpdates":null
    }
}

...

Versions Compared

Old Version 6

New Version Current

Key

Events

Comment Added

Comment Updated

Comment Deleted

Package Created

Package Status Updated

Pipeline Stage Completed

Release Started

Release Ended

Snapshot Completed

Tag Assigned

Tag Unassigned

Task Created

Release Started

Release Ended

Task Approved

Snapshot Completed

Task

Rejected

User Created

Workflow Completed

Page Comparison

Versions Compared

Old Version 6

New Version Current

Key

Events

Comment Added

Comment Updated

Comment Deleted

Package Created

Package Status Updated

Pipeline Stage Completed

Release Started

Release Ended

Snapshot Completed

Tag Assigned

Tag Unassigned

Task Created

Release Started

Release Ended

Task Approved

Snapshot Completed

Task

Rejected

User Created

Workflow Completed