Subscribe

UiPath Orchestrator

The UiPath Orchestrator Guide

Types of Events

Suggest Edits

The following describes all of the events you can subscribe to in Orchestrator and when they are triggered. Additionally, examples of the information you can receive, also known as a payload, are available for each event type.

Job Events

job.created

Triggered by the creation of one or multiple jobs that are pending execution. This webhook event is not sent to an external system if a Robot triggers it.

Payload example:

{
  "Type": "job.created",
  "EventId": "b02a39ddca5b4675aa87026c287f3cae",
  "Timestamp": "2018-11-26T14:34:30.719095Z",
  "StartInfo": {
    "ReleaseKey": "0237af09-80a9-450b-b3a0-20c15dd308fa",
    "Strategy": "Specific",
    "RobotIds": [
      81,
      78,
      86,
      87
    ],
    "JobsCount": 0,
    "Source": "Manual"
  },
  "Jobs": [
    {
      "Id": 148708,
      "Key": "e1c32fbf-5ef4-4080-a671-cf6ef75f359a",
      "State": "Pending",
      "Source": "Manual",
      "SourceType": "Manual",
      "BatchExecutionKey": "17e99516-2e87-475c-bce7-75b7d88ab5b4",
      "ReleaseName": "RunUntilStoppedManually_all",
      "Type": "Unattended",
      "Robot": {
        "Id": 78,
        "Name": "bench-zdqlGiDEkM",
        "MachineId": 77,
        "MachineName": "bench-ryenclhIkV",
        "Description": "FPZuy",
        "Version": "18.3",
        "UserName": "oqkMV",
        "Type": "Unattended",
        "HostingType": "Standard"
      },
      "Release": {
        "Id": 359,
        "Key": "0237af09-80a9-450b-b3a0-20c15dd308fa",
        "ProcessKey": "RunUntilStoppedManually",
        "ProcessVersion": "",
        "Name": "RunUntilStoppedManually_all",
        "Description": "",
        "IsLatestVersion": false,
        "InputArguments": null
      },
      "InputArguments": null,
      "OutputArguments": null
    },
    {
      "Id": 148709,
      "Key": "b571d943-305c-40a0-8de7-28fd689e67aa",
      "State": "Pending",
      "Source": "Manual",
      "SourceType": "Manual",
      "BatchExecutionKey": "17e99516-2e87-475c-bce7-75b7d88ab5b4",
      "ReleaseName": "RunUntilStoppedManually_all",
      "Type": "Unattended",
      "Robot": {
        "Id": 81,
        "Name": "bench-xdKZjRoHdh",
        "MachineId": 74,
        "MachineName": "bench-fwYwxYcDBf",
        "Description": "gKaiF",
        "Version": "18.3",
        "UserName": "ImDvI",
        "Type": "Unattended",
        "HostingType": "Standard"
      },
      "Release": {
        "Id": 359,
        "Key": "0237af09-80a9-450b-b3a0-20c15dd308fa",
        "ProcessKey": "RunUntilStoppedManually",
        "ProcessVersion": "",
        "Name": "RunUntilStoppedManually_all",
        "Description": "",
        "IsLatestVersion": false,
        "InputArguments": null
      },
      "InputArguments": null,
      "OutputArguments": null
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

job.started

Triggered when the execution of a job started on a Robot.

Payload example:

{
  "Type": "job.started",
  "EventId": "816648dda7394ef7804b5c893ff1c58a",
  "Timestamp": "2018-11-26T13:49:33.4532871Z",
  "Job": {
    "Id": 148649,
    "Key": "da8fe505-d2a7-4546-b723-cf58807d69ad",
    "State": "Running",
    "StartTime": "2018-11-26T13:49:33.4432884Z",
    "Info": "Waiting for execution to start...",
    "OutputArguments": null,
    "Robot": {
      "Id": 4778,
      "Name": "local",
      "MachineName": "PC-DOC"
    },
    "Release": {
      "Id": 353,
      "Key": "688c79ec-205d-4c6f-a7e2-87c4fb258a92",
      "ProcessKey": "Doc_AllEvents"
    }
  },
  "TenantId": 1,
  "OrganizationUnitId": 1
}

job.faulted

This event is triggered when a job failed to execute a job, regardless of the reason.

Payload example:

{
  "Type": "job.faulted",
  "EventId": "ec5afc6f07254520b8a6d31036b96975",
  "Timestamp": "2018-11-26T14:14:26.2879878Z",
  "Job": {
    "Id": 148671,
    "Key": "9cc6c2e4-237d-42f6-8cb8-43010652fb22",
    "State": "Faulted",
    "StartTime": "2018-11-26T14:14:25.637Z",
    "EndTime": "2018-11-26T14:14:26.2529616Z",
    "Info": "This workflow always fails\r\n\r\nAn ExceptionDetail, likely created by IncludeExceptionDetailInFaults=true, whose value is:\nSystem.InvalidOperationException: This workflow always fails\n   at System.Activities.Statements.Throw.Execute(CodeActivityContext context)\r\n   at System.Activities.CodeActivity.InternalExecute(ActivityInstance instance, ActivityExecutor executor, BookmarkManager bookmarkManager)\r\n   at System.Activities.ActivityInstance.Execute(ActivityExecutor executor, BookmarkManager bookmarkManager)\r\n   at System.Activities.Runtime.ActivityExecutor.ExecuteActivityWorkItem.ExecuteBody(ActivityExecutor executor, BookmarkManager bookmarkManager, Location resultLocation)",
    "OutputArguments": {},
    "Robot": {
      "Id": 4778,
      "Name": "local",
      "MachineName": "PC-DOC"
    },
    "Release": {
      "Id": 358,
      "Key": "8fad9c36-237b-49a6-a939-47963fb8099a",
      "ProcessKey": "FailingJob"
    }
  },
  "TenantId": 1,
  "OrganizationUnitId": 1
}

job.completed

This event is generated only when a job has finished executing successfully.

Payload example:

{
  "Type": "job.completed",
  "EventId": "15412ff77dce4d489fc32c273862839b",
  "Timestamp": "2018-11-26T14:37:26.3231812Z",
  "Job": {
    "Id": 148712,
    "Key": "d7a77655-3245-4d97-b127-04b3abebc439",
    "State": "Successful",
    "StartTime": "2018-11-26T14:37:25.433Z",
    "EndTime": "2018-11-26T14:37:26.2861846Z",
    "Info": "Job completed",
    "OutputArguments": {
      "product": 5000,
      "sum": 150,
      "diff": 50
    },
    "Robot": {
      "Id": 4778,
      "Name": "DocBot",
      "MachineName": "PC-DOC"
    },
    "Release": {
      "Id": 357,
      "Key": "6205f5a8-d762-4feb-98ec-d43534ef9f89",
      "ProcessKey": "Args_AddNumbers"
    }
  },
  "TenantId": 1,
  "OrganizationUnitId": 1
}

job.stopped

This event is triggered when a user manually stops a job.

Payload example:

{
  "Type": "job.stopped",
  "EventId": "51",
  "Timestamp": "2021-08-02T16:00:47.61",
  "Jobs": [
    {
      "Id": 17,
      "Key": "43200bd3-f4d3-4724-a43b-0f78b755b770",
      "State": "Stopped",
      "StartTime": "2021-08-02T16:00:47.403Z",
      "EndTime": "2021-08-02T16:00:47.403Z",
      "OutputArguments": null,
      "Robot": {
        "Id": 0
      },
      "Release": {
        "Id": 4,
        "Key": "82f2995d-ff57-4cad-b724-9cee46230272",
        "ProcessKey": "QueueItemsProcessing"
      }
    }
  ],
  "TenantId": 3,
  "OrganizationUnitId": 4,
  "UserId": 11
}

job.suspended

This event is triggered when a job is suspended through a long-running workflow.

Payload example:

{
  "Type": "job.suspended",
  "EventId": "15412ff77dce4d489fc32c273862839b",
  "Timestamp": "2018-11-26T14:37:26.3231812Z",
  "Job": {
    "Id": 148712,
    "Key": "d7a77655-3245-4d97-b127-04b3abebc439",
    "State": "Successful",
    "StartTime": "2018-11-26T14:37:25.433Z",
    "EndTime": "2018-11-26T14:37:26.2861846Z",
    "Info": "Job completed",
    "OutputArguments": {
      "product": 5000,
      "sum": 150,
      "diff": 50
    },
    "Robot": {
      "Id": 4778,
      "Name": "DocBot",
      "MachineName": "PC-DOC"
    },
    "Release": {
      "Id": 357,
      "Key": "6205f5a8-d762-4feb-98ec-d43534ef9f89",
      "ProcessKey": "Args_AddNumbers"
    }
  },
  "TenantId": 1,
  "OrganizationUnitId": 1

Robot Events

📘

Note:

Robot events sent in the context of a classic folder will include the OrganizationUnitId or FolderId in the payload, while those from modern folders will not. In the modern model, robots are not created within any specific folder. Read more about automatically provisioned robots here.

robot.created

Triggered when a new Robot is created in your Orchestrator instance.

Payload example:

{
  "Type": "robot.created",
  "EventId": "a1f904c0de844dd1811581a176dde54f",
  "Timestamp": "2018-11-26T14:20:37.6962672Z",
  "Robots": [
    {
      "Id": 5769,
      "Name": "TestDocBot",
      "MachineId": 618,
      "MachineName": "PC-DOC",
      "Description": "robot description",
      "UserName": "uipath\\new-user",
      "Type": "Unattended",
      "HostingType": "Standard",
      "Environments": [],
      "ExecutionSettings": {
        "TracingLevelState": true,
        "TracingLevel": "Off",
        "StudioNotifyServerState": true,
        "StudioNotifyServer": true,
        "LoginToConsoleState": false,
        "ResolutionWidthState": true,
        "ResolutionWidth": "1555",
        "ResolutionHeightState": true,
        "ResolutionHeight": "9001",
        "ResolutionDepthState": false,
        "FontSmoothingState": false
      }
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

robot.updated

This event is set off when an Orchestrator user changes the details of a Robot.

Payload example:

{
  "Type": "robot.updated",
  "EventId": "1b4cc368aa204a2291d036ce7ad659ff",
  "Timestamp": "2018-11-26T14:21:28.0199575Z",
  "Robots": [
    {
      "Id": 225,
      "Name": "DocBot",
      "MachineId": 150,
      "MachineName": "PC-DOC",
      "Description": "A robot for documentation.",
      "Version": "18.3",
      "UserName": "TkqRA",
      "Type": "Unattended",
      "HostingType": "Standard",
      "ExecutionSettings": {
        "TracingLevelState": true,
        "TracingLevel": "Error",
        "StudioNotifyServerState": true,
        "StudioNotifyServer": true,
        "LoginToConsoleState": true,
        "LoginToConsole": false,
        "ResolutionWidthState": true,
        "ResolutionWidth": "1200",
        "ResolutionHeightState": true,
        "ResolutionHeight": "1600",
        "ResolutionDepthState": false,
        "FontSmoothingState": false
      }
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

robot.deleted

This event is triggered when a Robot is deleted in your Orchestrator instance.

Payload example:

{
  "Type": "robot.deleted",
  "EventId": "c8401e57449a4b83a44e35a35be0738b",
  "Timestamp": "2018-11-26T14:19:18.2038517Z",
  "Robots": [
    {
      "Id": 159,
      "Name": "TestAPI",
      "MachineId": 117,
      "MachineName": "PC-DOC",
      "Description": "This is an API test.",
      "Version": "18.3",
      "UserName": "Mda",
      "Type": "Unattended",
      "HostingType": "Standard"
    },
    {
      "Id": 169,
      "Name": "DocBot,
      "MachineId": 122,
      "MachineName": "PC-DOC",
      "Description": "For testing purposes.",
      "Version": "18.3",
      "UserName": "Mda",
      "Type": "Unattended",
      "HostingType": "Standard"
    },
    {
      "Id": 171,
      "Name": "bench-iFPcNQWYGQ",
      "MachineId": 123,
      "MachineName": "PC-unAUMfGFGj",
      "Description": "Testing robot.",
      "Version": "18.3",
      "UserName": "Mda",
      "Type": "Unattended",
      "HostingType": "Standard"
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

robot.status

An event to which you can subscribe and receive notifications when the status of a Robot changes.

Payload example:

{
  "Type": "robot.status",
  "EventId": "980f4053fd6e4c04a3526d61cd80a7eb",
  "Timestamp": "2018-11-26T14:12:30.7943064Z",
  "Sessions": [
    {
      "SessionId": 4778,
      "RobotId": 4778,
      "HostMachineName": "PC-DOC",
      "State": "Busy",
      "ReportingTime": "2018-11-26T14:12:30.7463063Z",
      "IsUnresponsive": false
    }
  ],
  "TenantId": 1,
  "OrganizationUnitId": 1
}

Queue Events

📘

Note

Queue SLA information is only displayed for events on Cloud Platform Orchestrator services.

queue.created

You receive notifications for this event when a new queue has been created.

Payload example:

{
  "Type": "queue.created",
  "EventId": "d20b0839229443e8ab36c8fbb7cc8953",
  "Timestamp": "2018-11-26T14:31:14.4357176Z",
  "Queues": [
    {
      "Id": 40079,
      "Name": "new-queue-definition-name",
      "Description": "This the description of the queue.",
      "MaxNumberOfRetries": 3,
      "AcceptAutomaticallyRetry": true,
      "EnforceUniqueReference": true
      "SlaInMinutes": 1500,
      "RiskSlaInMinutes": 1140
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

queue.updated

A payload is sent to the indicated URL when the definition of the queue has been changed.

Payload example:

{
  "Type": "queue.updated",
  "EventId": "cc859a30057d430d97acb1c4da33c183",
  "Timestamp": "2018-11-26T14:31:45.3594898Z",
  "Queues": [
    {
      "Id": 40079,
      "Name": "new-queue-definition-name",
      "Description": "This is an update to the queue description.",
      "MaxNumberOfRetries": 3,
      "AcceptAutomaticallyRetry": true,
      "EnforceUniqueReference": true
      "SlaInMinutes": 1500,
      "RiskSlaInMinutes": 1140
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

queue.deleted

This event is triggered when a queue has been deleted from your Orchestrator instance.

Payload example:

{
  "Type": "queue.deleted",
  "EventId": "056a9c975ae84f99a2fcb5361349679b",
  "Timestamp": "2018-11-26T14:32:09.1778423Z",
  "Queues": [
    {
      "Id": 40079,
      "Name": "new-queue-definition-name",
      "Description": "This is an update to the queue description.",
      "MaxNumberOfRetries": 3,
      "AcceptAutomaticallyRetry": true,
      "EnforceUniqueReference": true
      "SlaInMinutes": 1500,
      "RiskSlaInMinutes": 1140
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

QueueItem Events

queueItem.added

An event triggered when an item has been added to a queue.

Payload example:

{
  "Type": "queueItem.added",
  "EventId": "9314c897bcb14bcfaa9d1f5752793153",
  "Timestamp": "2018-11-26T14:14:31.2113498Z",
  "Queue": {
    "Id": 40014,
    "Name": "temp",
    "Description": "33 Featured",
    "MaxNumberOfRetries": 0,
    "AcceptAutomaticallyRetry": false,
    "EnforceUniqueReference": false
  },
  "QueueItems": [
    {
      "Id": 22135,
      "Key": "0e7fd9f2-5063-4ab4-a43e-5c3bf5ce6546",
      "QueueDefinitionId": 40014,
      "Status": "InProgress",
      "ReviewStatus": "None",
      "Priority": "High",
      "CreationTime": "2018-11-26T14:14:31.1963476Z",
      "StartProcessing": "2018-11-26T14:14:31.1963476Z",
      "SecondsInPreviousAttempts": 0,
      "RetryNumber": 0,
      "SpecificContent": {
        "field1": "Jane Doe",
        "field2": 125123,
        "field3": false,
        "field4": "janedoe@work.com"
      }
    }
  ],
  "TenantId": 1,
  "UserId": 4947
}

queueItem.transactionStarted

You start receiving notifications for this event at a custom URL when you start processing queue items.

Payload example:

{
  "Type": "queueItem.transactionStarted",
  "EventId": "49ff13b6ad4e47d58a8d3e47a771cb15",
  "Timestamp": "2018-11-26T14:17:21.4332911Z",
  "QueueItem": {
    "Id": 22170,
    "Key": "db36add9-dcde-4b79-83ac-bfb8ed0764e2",
    "QueueDefinitionId": 40014,
    "Status": "InProgress",
    "ReviewStatus": "None",
    "Priority": "High",
    "CreationTime": "2018-11-26T14:17:21.4182874Z",
    "StartProcessing": "2018-11-26T14:17:21.4182874Z",
    "SecondsInPreviousAttempts": 0,
    "RetryNumber": 0,
    "SpecificContent": {
      "field1": "A string",
      "field2": 35125,
      "field3": true
    }
  },
  "Queue": {
    "Id": 40014,
    "Name": "temp",
    "Description": "33 Featured",
    "MaxNumberOfRetries": 0,
    "AcceptAutomaticallyRetry": false,
    "EnforceUniqueReference": false
  },
  "TenantId": 1,
  "UserId": 4947
}

queueItem.transactionCompleted

This event is triggered if a transaction has been processed successfully.

Payload example:

{
  "Type": "queueItem.transactionCompleted",
  "EventId": "916b1272c7714e92987788cab760cff3",
  "Timestamp": "2018-11-26T14:30:18.3948142Z",
  "QueueItem": {
    "Id": 22193,
    "Key": "398a6d1f-615f-499c-86d3-ee325ab865b4",
    "QueueDefinitionId": 40014,
    "Status": "Successful",
    "ReviewStatus": "None",
    "Priority": "High",
    "CreationTime": "2018-11-26T14:30:18.127Z",
    "StartProcessing": "2018-11-26T14:30:18.127Z",
    "EndProcessing": "2018-11-26T14:30:18.3858151Z",
    "SecondsInPreviousAttempts": 0,
    "RetryNumber": 0,
    "Robot": {
      "Id": 4778,
      "Name": "local",
      "MachineId": 2229,
      "MachineName": "PC-DOC",
      "Version": "18.3.0.453",
      "UserName": "UIPATH\\doc.test",
      "Type": "Unattended",
      "HostingType": "Standard"
    },
    "SpecificContent": {
      "field1": "Jane Doe",
      "field2": 125123,
      "field3": false,
      "field4": "janedoe@work.com"
    },
    "Output": {
      "PetName": "Ksiusha",
      "NrOfLegs": 4
    }
  },
  "Queue": {
    "Id": 40014,
    "Name": "temp",
    "Description": "33 Featured",
    "MaxNumberOfRetries": 0,
    "AcceptAutomaticallyRetry": false,
    "EnforceUniqueReference": false
  },
  "TenantId": 1,
  "UserId": 4947
}

queueItem.transactionFailed

A payload is sent to your custom URL if a queue item fails with an application or business exception.

Payload example:

{
  "Type": "queueItem.transactionFailed",
  "EventId": "6fe77f39c7f544a0a6fb0dd29842d7d7",
  "Timestamp": "2018-11-26T14:16:31.9632204Z",
  "QueueItem": {
    "Id": 22160,
    "Key": "e855153c-6b4d-441a-82b5-3d4585214485",
    "QueueDefinitionId": 40014,
    "Status": "Failed",
    "ReviewStatus": "None",
    "ProcessingException": {
      "Reason": "Failed",
      "Details": "Error during Heartbeat Status shutdown flushCastle.MicroKernel.ComponentNotFoundException: No component for supporting the service UiPath.Core.Caching.IHeartbeatStatusFlush was found",
      "Type": "BusinessException"
    },
    "Priority": "High",
    "CreationTime": "2018-11-26T14:16:31.54Z",
    "StartProcessing": "2018-11-26T14:16:31.54Z",
    "EndProcessing": "2018-11-26T14:16:31.7942218Z",
    "SecondsInPreviousAttempts": 0,
    "RetryNumber": 0,
    "Robot": {
      "Id": 4778,
      "Name": "local",
      "MachineId": 2229,
      "MachineName": "PC-DOC",
      "Version": "18.3.0.453",
      "UserName": "UIPATH\\doc.test",
      "Type": "Unattended",
      "HostingType": "Standard"
    },
    "SpecificContent": {
      "field1": "A string",
      "field2": 35125,
      "field3": true
    }
  },
  "Queue": {
    "Id": 40014,
    "Name": "temp",
    "Description": "33 Featured",
    "MaxNumberOfRetries": 0,
    "AcceptAutomaticallyRetry": false,
    "EnforceUniqueReference": false
  },
  "TenantId": 1,
  "UserId": 4947
}

queueItem.transactionAbandoned

This event sends notifications when a queue item was abandoned (has not been processed for 24 hours).

Payload example:

{
  "Type": "queueItem.transactionAbandoned",
  "EventId": "e216476b5fa34c77ac3b0ed7669bf4d1",
  "Timestamp": "2018-11-26T14:52:22.436302Z",
  "Queue": {
    "Id": 40014,
    "Name": "temp",
    "Description": "33 Featured",
    "MaxNumberOfRetries": 0,
    "AcceptAutomaticallyRetry": false,
    "EnforceUniqueReference": false
  },
  "QueueItems": [
    {
      "Id": 22189,
      "Key": "7434a2cd-acfe-4cb3-932e-296b0c57bcb5",
      "QueueDefinitionId": 40014,
      "Status": "Abandoned",
      "ReviewStatus": "None",
      "Priority": "High",
      "CreationTime": "2018-11-26T14:19:01.66Z",
      "StartProcessing": "2018-11-17T14:19:01.66Z",
      "EndProcessing": "2018-11-26T14:19:01.95Z",
      "SecondsInPreviousAttempts": 0,
      "RetryNumber": 0,
      "Robot": {
        "Id": 4778,
        "Name": "local",
        "MachineId": 2229,
        "MachineName": "PC-DOC",
        "Version": "18.3.0.453",
        "UserName": "UIPATH\\test.doc",
        "Type": "Unattended",
        "HostingType": "Standard"
      },
      "SpecificContent": {
        "field1": "Jane Doe",
        "field2": 125123,
        "field3": false,
        "field4": "janedoe@work.com"
      },
      "Output": {}
    },
    {
      "Id": 22190,
      "Key": "15beaad8-fc0f-4989-9d5b-621fc350a20d",
      "QueueDefinitionId": 40014,
      "Status": "Abandoned",
      "ReviewStatus": "None",
      "ProcessingException": {
        "Reason": "Failed",
        "Details": "Error during Heartbeat Status shutdown flushCastle.MicroKernel.ComponentNotFoundException: No component for supporting the service UiPath.Core.Caching.IHeartbeatStatusFlush was found",
        "Type": "BusinessException"
      },
      "Priority": "High",
      "CreationTime": "2018-11-26T14:19:01.797Z",
      "StartProcessing": "2018-11-17T14:19:01.797Z",
      "EndProcessing": "2018-11-26T14:19:02.09Z",
      "SecondsInPreviousAttempts": 0,
      "RetryNumber": 0,
      "Robot": {
        "Id": 4778,
        "Name": "local",
        "MachineId": 2229,
        "MachineName": "PC-DOC",
        "Version": "18.3.0.453",
        "UserName": "UIPATH\\test.doc",
        "Type": "Unattended",
        "HostingType": "Standard"
      },
      "SpecificContent": {
        "field1": "A string",
        "field2": 35125,
        "field3": true
      }
    }
  ],
  "TenantId": 1,
  "OrganizationUnitId": 1
}

Process Events

process.created

The indicated target receives a payload when a new process is created in your Orchestrator instances.

Payload example:

{
  "Type": "process.created",
  "EventId": "aa55eb899ed241cdbeb6b6ef417f1dd5",
  "Timestamp": "2018-11-26T14:22:58.44896Z",
  "Releases": [
    {
      "Id": 363,
      "Key": "8a3db114-69c3-4b67-a8e7-7a5985bde461",
      "ProcessKey": "BlankProcess_2",
      "ProcessVersion": "1.0.6899.31694",
      "Name": "BlankProcess_2_all",
      "Description": "BlankProcess description",
      "IsLatestVersion": false,
      "InputArguments": {
        "a": "arg_value_a",
        "b": "arg_value_b"
      }
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

process.updated

This event is triggered when a process has been updated.

Payload example:

{
  "Type": "process.updated",
  "EventId": "dc61eec5aad148c5817036b3cc2f5e00",
  "Timestamp": "2018-11-26T14:25:27.5423521Z",
  "Releases": [
    {
      "Id": 353,
      "Key": "688c79ec-205d-4c6f-a7e2-87c4fb258a92",
      "ProcessKey": "Doc_AllEvents",
      "ProcessVersion": "1.0.6904.29557",
      "Name": "Doc_AllEvents_3bf688c8-01e",
      "Description": "",
      "IsLatestVersion": false,
      "Environment": {
        "Id": 1,
        "Name": "3bf688c8-01e"
      },
      "InputArguments": {
        "queue": "temp"
      }
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

process.deleted

The specified URL receives notifications when a process is removed.

Payload example:

{
  "Type": "process.deleted",
  "EventId": "0766775e9f6847818a6b04c6465c9a8f",
  "Timestamp": "2018-11-26T14:27:32.2656118Z",
  "Releases": [
    {
      "Id": 363,
      "Key": "8a3db114-69c3-4b67-a8e7-7a5985bde461",
      "ProcessKey": "BlankProcess_2",
      "ProcessVersion": "1.0.6899.31694",
      "Name": "BlankProcess_2_all",
      "Description": "BlankProcess description",
      "IsLatestVersion": false,
      "Environment": {
        "Id": 332,
        "Name": "all"
      },
      "InputArguments": {
        "a": "arg_value_a",
        "b": "arg_value_b"
      }
    }
  ],
  "TenantId": 1,
  "UserId": 2
}

Trigger Events

schedule.failed

Launched when the execution of a trigger has failed.

Payload example:

{
  "Type": "schedule.failed",
  "EventId": "990cfc99f9174d70a6831f06f42d36dd",
  "Timestamp": "2018-11-26T14:13:05.4013596Z",
  "ProcessSchedule": {
    "Id": 134,
    "Name": "aProcess",
    "Enabled": true,
    "EnvironmentId": "1",
    "EnvironmentName": "3bf688c8-01e",
    "StartProcessCron": "5/20 * * * * ? *",
    "StartStrategy": "Specific",
    "ExternalJobKey": "b8abfb7d-22ef-4b90-9976-d85da1d3ce63",
    "TimeZoneId": "UTC",
    "TimeZoneIana": "Etc/UTC",
    "UseCalendar": false,
    "Release": {
      "Id": 134,
      "Key": "6205f5a8-d702-4feb-98ec-d43534ef0f89",
      "ProcessKey": "Args_AddNumbers"
    },
    "ExecutorRobots": [],
    "InputArguments": {
      "x": 100,
      "y": 50
    }
  },
  "Reason": "The robots already have pending jobs for this Process",
  "TenantId": 1,
  "OrganizationUnitId": 1
}

{
  "Type": "schedule.failed",
  "EventId": "2cc0ec4571f54819bb71c6c7bd81eee1",
  "Timestamp": "2018-11-26T14:39:46.0357141Z",
  "ProcessSchedule": {
    "Id": 133,
    "Name": "anotherProcess",
    "Enabled": true,
    "EnvironmentId": "1",
    "EnvironmentName": "3bf688c8-01e",
    "StartProcessCron": "0/10 * * * * ? *",
    "StartStrategy": "All",
    "StopStrategy": "Kill",
    "ExternalJobKey": "959c00a9-8ed2-4e1a-9115-2e12a45c1ca2",
    "TimeZoneId": "UTC",
    "TimeZoneIana": "Etc/UTC",
    "UseCalendar": false,
    "Release": {
      "Id": 133,
      "Key": "688c79ec-205d-4c6f-a7e2-87c4fb258a92",
      "ProcessKey": "Doc_AllEvents"
    },
    "ExecutorRobots": [
      {
        "Id": 4778,
        "Name": "local",
        "MachineName": "PC-DOC"
      }
    ],
    "InputArguments": {
      "queue": "temp"
    }
  },
  "Reason": "Starting jobs is not possible. A valid license is required.",
  "TenantId": 1,
  "OrganizationUnitId": 1
}

Actions Events

task.assignmentChanged

Triggered by changes made to the actions assignee (adding a new one, changing the existing one, or removing it).

Payload example:

{
  "Type": "task.assignmentChanged",
  "EventId": "71cfbe72f1b740bdb33bf3c62a082686",
  "Timestamp": "2020-01-09T11:14:52.3395506Z",
  "Tasks": [
    {
      "Title": "Performance Task",
      "Type": "FormTask",
      "Priority": "Critical",
      "Status": "Pending",
      "CreationTime": "2020-01-09T11:13:50.047Z",
      "Id": 209,
      "OrganizationUnitId": 200,
      "AssignedToUserId": 58571
    }
  ],
  "TenantId": 1,
  "OrganizationUnitId": 200,
  "UserId": 52454
}

task.completed

Triggered whenever an action is marked as completed in Orchestrator.

Payload example:

{
  "Type": "task.completed",
  "EventId": "5b80ee1583304360ae8cbaeb85e4dbe7",
  "Timestamp": "2020-01-09T11:14:59.317576Z",
  "Tasks": [
    {
      "Title": "Invoice Processing",
      "Type": "FormTask",
      "Priority": "High",
      "Status": "Completed",
      "CreationTime": "2020-01-09T11:13:49.907Z",
      "Id": 208,
      "OrganizationUnitId": 200,
      "AssignedToUserId": 52454,
      "Action": "submit"
    }
  ],
  "TenantId": 1,
  "OrganizationUnitId": 200,
  "UserId": 52454
}

task.created

Triggered whenever a new action is created in Orchestrator.

Payload example:

{
  "Type": "task.created",
  "EventId": "3d7034c0fcbf435992377e21dde3fa13",
  "Timestamp": "2020-01-09T11:14:17.0622545Z",
  "Tasks": [
    {
      "Title": "Orchestrator is my nemesis",
      "Type": "FormTask",
      "Priority": "High",
      "Status": "Unassigned",
      "CreationTime": "2020-01-09T11:14:17.0466387Z",
      "Id": 210,
      "OrganizationUnitId": 200
    }
  ],
  "TenantId": 1,
  "OrganizationUnitId": 200,
  "UserId": 59082
}

task.saved

Triggered whenever an action is saved before being completed.

Payload example:

{ 
"Type": "task.saved", 
"EventId": "xxxxxx", 
"Timestamp": "2018-11-26T14:17:21.4332911Z", 
"UserId": 999, 
"TenantId":1, 
"OrganizationUnitId":1, 
"Task":
{ 
"Title": "string", 
"Type": "FormTask", 
"Priority": "Low", 
"Status": "Pending", 
"CreationTime": "2019-08-16T07:16:25.773Z", 
"TaskCatalogName": "string", 
"Id": 0 
"AssignedToUserId": 888, 
"Action": "" 
}

task.deleted

The specified URL receives notifications when an action is removed.

Payload example:

{
  "Type": "task.deleted",
  "EventId": "2",
  "Timestamp": "2021-01-19T06:30:26.25",
  "Tasks": [
    {
      "Title": "High prio task with Catalog",
      "Type": "FormTask",
      "Priority": "High",
      "Status": 3,
      "CreationTime": "2020-11-27T14:47:46.647Z",
      "Id": 7,
      "OrganizationUnitId": 1,
      "AssignedToUserId": 3,
      "DeleterUserId": 3,
      "DeletionTime": "2021-01-19T06:30:24.6799181Z"
    }
  ],
  "TenantId": 1,
  "UserId": 3
}

task.forwarded

Triggered whenever an action is forwarded to other users.

Payload example:

{
    "Type": "task.forwarded",
    "EventId": "12088840",
    "Timestamp": "2021-01-18T05:08:40.58",
    "Tasks": [
        {
            "Title": "Sample Form Task",
            "Type": "FormTask",
            "Priority": "Medium",
            "Status": "Pending",
            "CreationTime": "2020-10-28T11:17:28.023Z",
            "Id": 18870,
            "OrganizationUnitId": 101623,
            "AssignedToUserId": 221732,
            "ForwardedByUserId": 221731
        }
    ],
    "TenantId": 46729,
    "OrganizationUnitId": 101623,
    "UserId": 221731
}

Updated about a year ago

Types of Events

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.