Processes
Same as GetProcessById
Process unique identifier
Process version
Success
Process not found
GET /api/v1/processes/{processGuid}/versions/{processVersion} HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"data": {
"isDeleted": true,
"version": 1,
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"id": 1,
"name": "text",
"modified": "2025-09-07T10:06:08.662Z",
"modifier": "text",
"description": "text",
"isNotLatestVersion": true,
"changeDescription": "text",
"bpmn": "text",
"elementParameters": [
{
"id": "text",
"type": "Start",
"parameters": {
"ANY_ADDITIONAL_PROPERTY": [
"[Circular Reference]"
]
},
"selectedTypeId": "text",
"promoteResultAs": "text",
"name": "text",
"description": "text",
"isDefault": true,
"shouldRetry": true,
"maxRetryCount": 1,
"shouldNotLogResult": true,
"shouldDispose": true
}
],
"manualTrigger": [
[
[
[
"[Circular Reference]"
]
]
]
],
"obsoleteTasks": [
{
"uri": "text",
"argumentsJson": "text",
"returnType": "text",
"name": "text",
"displayName": "text",
"packageName": "text",
"description": "text",
"isNotLatestVersion": true,
"isStandard": true,
"isDotNet": true
}
],
"draftId": 1,
"idOfBaseProcessForDraft": 1,
"isDraft": true,
"isSubprocess": true,
"graphData": {
"ANY_ADDITIONAL_PROPERTY": [
[
[
"[Circular Reference]"
]
]
]
},
"triggerData": [
[
[
[
"[Circular Reference]"
]
]
]
],
"majorVersion": 1,
"minorVersion": 1,
"isMigration": true,
"activateIfNew": true,
"frendsVersion": "text",
"ignoreDependencyConflicts": true,
"documentationMarkdown": "text",
"targetFramework": "text",
"apiSpecId": 1,
"isForMonitoringRule": true,
"validationOnly": true,
"cancellationDisabled": true,
"processVariables": [
{
"name": "text",
"value": "text",
"isSecret": true,
"mode": "text",
"description": "text"
}
],
"processTemplate": {
"id": 1,
"name": "text",
"modifier": "text",
"modified": "2025-09-07T10:06:08.662Z",
"majorVersion": 1,
"minorVersion": 1,
"targetFramework": "text",
"frendsVersion": "text",
"isSubprocess": true,
"staticRequiredEnvironmentVariablesJson": "text",
"isForMonitoringRule": true,
"cancellationDisabled": true,
"description": "text",
"changeDescription": "text",
"bpmn": "text",
"elementParameters": "text",
"promotedResultVariablesJson": "text",
"usedSubprocessesJson": "text",
"usedTasksJson": "text",
"triggersJson": "text",
"manualTriggerJson": "text",
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"isListed": true,
"version": 1,
"isDeleted": true,
"processVariablesJson": "text",
"processTags": "text",
"templateTags": [
"text"
],
"getVersion": {
"major": 1,
"minor": 1,
"build": 1,
"revision": 1,
"majorRevision": 1,
"minorRevision": 1
}
},
"processTemplateDeviated": "2025-09-07T10:06:08.662Z",
"nextProcessTemplate": {
"id": 1,
"name": "text",
"modifier": "text",
"modified": "2025-09-07T10:06:08.662Z",
"majorVersion": 1,
"minorVersion": 1,
"targetFramework": "text",
"frendsVersion": "text",
"isSubprocess": true,
"staticRequiredEnvironmentVariablesJson": "text",
"isForMonitoringRule": true,
"cancellationDisabled": true,
"description": "text",
"changeDescription": "text",
"bpmn": "text",
"elementParameters": "text",
"promotedResultVariablesJson": "text",
"usedSubprocessesJson": "text",
"usedTasksJson": "text",
"triggersJson": "text",
"manualTriggerJson": "text",
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"isListed": true,
"version": 1,
"isDeleted": true,
"processVariablesJson": "text",
"processTags": "text",
"templateTags": [
"text"
],
"getVersion": {
"major": 1,
"minor": 1,
"build": 1,
"revision": 1,
"majorRevision": 1,
"minorRevision": 1
}
}
},
"links": {
"deployments": {
"uri": "https://example.com",
"method": "text"
},
"delete": {
"uri": "https://example.com",
"method": "text"
}
}
}
Same as GetProcess
Process version unique identifier
Success
Process not found
GET /api/v1/processes/{id} HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"data": {
"isDeleted": true,
"version": 1,
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"id": 1,
"name": "text",
"modified": "2025-09-07T10:06:08.662Z",
"modifier": "text",
"description": "text",
"isNotLatestVersion": true,
"changeDescription": "text",
"bpmn": "text",
"elementParameters": [
{
"id": "text",
"type": "Start",
"parameters": {
"ANY_ADDITIONAL_PROPERTY": [
"[Circular Reference]"
]
},
"selectedTypeId": "text",
"promoteResultAs": "text",
"name": "text",
"description": "text",
"isDefault": true,
"shouldRetry": true,
"maxRetryCount": 1,
"shouldNotLogResult": true,
"shouldDispose": true
}
],
"manualTrigger": [
[
[
[
"[Circular Reference]"
]
]
]
],
"obsoleteTasks": [
{
"uri": "text",
"argumentsJson": "text",
"returnType": "text",
"name": "text",
"displayName": "text",
"packageName": "text",
"description": "text",
"isNotLatestVersion": true,
"isStandard": true,
"isDotNet": true
}
],
"draftId": 1,
"idOfBaseProcessForDraft": 1,
"isDraft": true,
"isSubprocess": true,
"graphData": {
"ANY_ADDITIONAL_PROPERTY": [
[
[
"[Circular Reference]"
]
]
]
},
"triggerData": [
[
[
[
"[Circular Reference]"
]
]
]
],
"majorVersion": 1,
"minorVersion": 1,
"isMigration": true,
"activateIfNew": true,
"frendsVersion": "text",
"ignoreDependencyConflicts": true,
"documentationMarkdown": "text",
"targetFramework": "text",
"apiSpecId": 1,
"isForMonitoringRule": true,
"validationOnly": true,
"cancellationDisabled": true,
"processVariables": [
{
"name": "text",
"value": "text",
"isSecret": true,
"mode": "text",
"description": "text"
}
],
"processTemplate": {
"id": 1,
"name": "text",
"modifier": "text",
"modified": "2025-09-07T10:06:08.662Z",
"majorVersion": 1,
"minorVersion": 1,
"targetFramework": "text",
"frendsVersion": "text",
"isSubprocess": true,
"staticRequiredEnvironmentVariablesJson": "text",
"isForMonitoringRule": true,
"cancellationDisabled": true,
"description": "text",
"changeDescription": "text",
"bpmn": "text",
"elementParameters": "text",
"promotedResultVariablesJson": "text",
"usedSubprocessesJson": "text",
"usedTasksJson": "text",
"triggersJson": "text",
"manualTriggerJson": "text",
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"isListed": true,
"version": 1,
"isDeleted": true,
"processVariablesJson": "text",
"processTags": "text",
"templateTags": [
"text"
],
"getVersion": {
"major": 1,
"minor": 1,
"build": 1,
"revision": 1,
"majorRevision": 1,
"minorRevision": 1
}
},
"processTemplateDeviated": "2025-09-07T10:06:08.662Z",
"nextProcessTemplate": {
"id": 1,
"name": "text",
"modifier": "text",
"modified": "2025-09-07T10:06:08.662Z",
"majorVersion": 1,
"minorVersion": 1,
"targetFramework": "text",
"frendsVersion": "text",
"isSubprocess": true,
"staticRequiredEnvironmentVariablesJson": "text",
"isForMonitoringRule": true,
"cancellationDisabled": true,
"description": "text",
"changeDescription": "text",
"bpmn": "text",
"elementParameters": "text",
"promotedResultVariablesJson": "text",
"usedSubprocessesJson": "text",
"usedTasksJson": "text",
"triggersJson": "text",
"manualTriggerJson": "text",
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"isListed": true,
"version": 1,
"isDeleted": true,
"processVariablesJson": "text",
"processTags": "text",
"templateTags": [
"text"
],
"getVersion": {
"major": 1,
"minor": 1,
"build": 1,
"revision": 1,
"majorRevision": 1,
"minorRevision": 1
}
}
},
"links": {
"deployments": {
"uri": "https://example.com",
"method": "text"
},
"delete": {
"uri": "https://example.com",
"method": "text"
}
}
}
If response data is empty there were no Processes found with the chosen filters
Current page number. Default value is 1.
Maximum page size is 200. Default page size is 30.
Filter Processes by unique identifier
Filter Processes by name
Success
GET /api/v1/processes HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
Success
{
"data": [
{
"isDeleted": true,
"version": 1,
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"id": 1,
"name": "text",
"modified": "2025-09-07T10:06:08.662Z",
"modifier": "text",
"description": "text",
"isNotLatestVersion": true,
"changeDescription": "text",
"bpmn": "text",
"elementParameters": [
{
"id": "text",
"type": "Start",
"parameters": {
"ANY_ADDITIONAL_PROPERTY": "[Circular Reference]"
},
"selectedTypeId": "text",
"promoteResultAs": "text",
"name": "text",
"description": "text",
"isDefault": true,
"shouldRetry": true,
"maxRetryCount": 1,
"shouldNotLogResult": true,
"shouldDispose": true
}
],
"manualTrigger": [
[
[
"[Circular Reference]"
]
]
],
"obsoleteTasks": [
{
"uri": "text",
"argumentsJson": "text",
"returnType": "text",
"name": "text",
"displayName": "text",
"packageName": "text",
"description": "text",
"isNotLatestVersion": true,
"isStandard": true,
"isDotNet": true
}
],
"draftId": 1,
"idOfBaseProcessForDraft": 1,
"isDraft": true,
"isSubprocess": true,
"graphData": {
"ANY_ADDITIONAL_PROPERTY": [
[
"[Circular Reference]"
]
]
},
"triggerData": [
[
[
"[Circular Reference]"
]
]
],
"majorVersion": 1,
"minorVersion": 1,
"isMigration": true,
"activateIfNew": true,
"frendsVersion": "text",
"ignoreDependencyConflicts": true,
"documentationMarkdown": "text",
"targetFramework": "text",
"apiSpecId": 1,
"isForMonitoringRule": true,
"validationOnly": true,
"cancellationDisabled": true,
"processVariables": [
{
"name": "text",
"value": "text",
"isSecret": true,
"mode": "text",
"description": "text"
}
],
"processTemplate": {
"id": 1,
"name": "text",
"modifier": "text",
"modified": "2025-09-07T10:06:08.662Z",
"majorVersion": 1,
"minorVersion": 1,
"targetFramework": "text",
"frendsVersion": "text",
"isSubprocess": true,
"staticRequiredEnvironmentVariablesJson": "text",
"isForMonitoringRule": true,
"cancellationDisabled": true,
"description": "text",
"changeDescription": "text",
"bpmn": "text",
"elementParameters": "text",
"promotedResultVariablesJson": "text",
"usedSubprocessesJson": "text",
"usedTasksJson": "text",
"triggersJson": "text",
"manualTriggerJson": "text",
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"isListed": true,
"version": 1,
"isDeleted": true,
"processVariablesJson": "text",
"processTags": "text",
"templateTags": [
"text"
],
"getVersion": {
"major": 1,
"minor": 1,
"build": 1,
"revision": 1,
"majorRevision": 1,
"minorRevision": 1
}
},
"processTemplateDeviated": "2025-09-07T10:06:08.662Z",
"nextProcessTemplate": {
"id": 1,
"name": "text",
"modifier": "text",
"modified": "2025-09-07T10:06:08.662Z",
"majorVersion": 1,
"minorVersion": 1,
"targetFramework": "text",
"frendsVersion": "text",
"isSubprocess": true,
"staticRequiredEnvironmentVariablesJson": "text",
"isForMonitoringRule": true,
"cancellationDisabled": true,
"description": "text",
"changeDescription": "text",
"bpmn": "text",
"elementParameters": "text",
"promotedResultVariablesJson": "text",
"usedSubprocessesJson": "text",
"usedTasksJson": "text",
"triggersJson": "text",
"manualTriggerJson": "text",
"uniqueIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"isListed": true,
"version": 1,
"isDeleted": true,
"processVariablesJson": "text",
"processTags": "text",
"templateTags": [
"text"
],
"getVersion": {
"major": 1,
"minor": 1,
"build": 1,
"revision": 1,
"majorRevision": 1,
"minorRevision": 1
}
},
"links": {
"deployments": {
"uri": "https://example.com",
"method": "text"
},
"delete": {
"uri": "https://example.com",
"method": "text"
}
}
}
],
"paging": {
"currentPage": 1,
"pageSize": 1,
"totalCount": 1,
"firstPage": "https://example.com",
"lastPage": "https://example.com",
"nextPage": "https://example.com",
"previousPage": "https://example.com"
}
}
Unique identifier for Process to delete
No Content
No content
Not Found
DELETE /api/v1/processes/{processGuid} HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
No content
Same as ExportWithId. Process Variables values are taken the Development Agent Group.
Process unique identifier
Process version
Success
Process not found
GET /api/v1/processes/{processGuid}/versions/{processVersion}/export HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
binary
Same as Export. Process Variables values are taken the Development Agent Group.
Process version unique identifier
Success
Process not found
GET /api/v1/processes/{id}/export HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
binary
Process Variables values are taken the Development Agent Group.
List of Process Id's that should be exported.
Success
GET /api/v1/processes/batch-export HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
Success
binary
This can be a very slow action. Please make sure your client has a long enough timeout so that the operation does not get cancelled.
File to upload.
Setting for deciding what to do when a Process GUID already exists. Error - the request will fail if Process exists.UseExisting - will not import Processes that exist.NewVersion - will update the existing Process to the imported one.NewActiveElement - will create a new Process with an Activated Trigger.NewInactiveElement - will create a new Process with an Deactivated Trigger.
Error
Possible values: Process(es) imported successfully
File not found
Client Error
Error in compilation
POST /api/v1/processes/batch-import HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 42
{
"file": "binary",
"importConflict": "Error"
}
{
"data": {
"name": "text",
"elementIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"id": 1,
"resourceLocation": "https://example.com",
"version": 1
}
}
Was this helpful?