/api/helpdesk/processes/{processId}/parallel-tickets/{parallelTicketId}

Exposes one parallel-ticket definition below a ticket process.

Start conditions use native condition data. Clients should obtain valid condition types and field operators from editor metadata. Conditions in one list are combined with logical AND. The conditionData property is a JSON string, not an embedded JSON object.

For example, this definition starts after activity activity-review was visited and the main ticket has priority 2. The referenced activity and field key must exist in the same process; EQUALS must be listed for that field by editor metadata:

 {
   "id": "parallel-security",
   "name": "Security review",
   "startActivityId": "parallel-start",
   "startCondition": [
     {"type":"activityVisited",
      "conditionData":"{\"itemId\":\"activity-review\",\"ignoreIfNoLongerReachable\":false}"},
     {"type":"ticketHasValue",
      "conditionData":"{\"referencedTicket\":null,\"ticketFieldKey\":\"priority\",\"operator\":\"EQUALS\",\"value\":\"2\"}"}
   ],
   "deactivated": false,
   "relativeLatestStart": null,
   "actionOnMainTicketEnd": 42
 }
 

Exposes one parallel-ticket definition below a ticket process.

Start conditions use native condition data. Clients should obtain valid condition types and field operators from editor metadata. Conditions in one list are combined with logical AND. The conditionData property is a JSON string, not an embedded JSON object.

For example, this definition starts after activity activity-review was visited and the main ticket has priority 2. The referenced activity and field key must exist in the same process; EQUALS must be listed for that field by editor metadata:

 {
   "id": "parallel-security",
   "name": "Security review",
   "startActivityId": "parallel-start",
   "startCondition": [
     {"type":"activityVisited",
      "conditionData":"{\"itemId\":\"activity-review\",\"ignoreIfNoLongerReachable\":false}"},
     {"type":"ticketHasValue",
      "conditionData":"{\"referencedTicket\":null,\"ticketFieldKey\":\"priority\",\"operator\":\"EQUALS\",\"value\":\"2\"}"}
   ],
   "deactivated": false,
   "relativeLatestStart": null,
   "actionOnMainTicketEnd": 42
 }
 

# Request
GET /api/helpdesk/processes/<processId>/parallel-tickets/<parallelTicketId> HTTP/1.1
Accept: application/json
Authorization: Bearer <access-token>

# Response
HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": "4sr2xsmoedl35omst4qn2rs8j",
    "name": "string",
    "activities": [
        {
            "nextProcessToStart": "dq7yrib057lrpo4uba39dyl5o",
            "followUpActivities": [
                
            ],
            "ticketText": null,
            "mainTicketTextInParallelMode": "NONE",
            "name": "string"
        }
    ],
    "startActivityId": "bhgu1npktz1coobweefodkb0i",
    "startCondition": [
        {
            "conditionData": "string",
            "type": "string"
        }
    ]
}

Patches branch settings against the latest process snapshot.

Example:

 PATCH /api/helpdesk/processes/{processId}/parallel-tickets/{parallelTicketId}
 {"name":"Security review","deactivated":false,
  "startCondition":[{"type":"ticketFinished",
  "conditionData":"{\"itemId\":\"parallel-data\",\"ignoreIfNoLongerReachable\":true}"}]}
 

# Request
PATCH /api/helpdesk/processes/<processId>/parallel-tickets/<parallelTicketId> HTTP/1.1
Accept: application/json
Authorization: Bearer <access-token>
Content-Type: application/json

{
    "startActivityId": "7qt3z57ifowvn8ta8mtr4ktsw",
    "startCondition": [
        {
            "conditionData": "string",
            "type": "string"
        }
    ],
    "clearActionOnMainTicketEnd": true,
    "actionOnMainTicketEnd": 0,
    "clearRelativeLatestStart": true
}

# Response
HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": "4sr2xsmoedl35omst4qn2rs8j",
    "name": "string",
    "activities": [
        {
            "nextProcessToStart": "dq7yrib057lrpo4uba39dyl5o",
            "followUpActivities": [
                
            ],
            "ticketText": null,
            "mainTicketTextInParallelMode": "NONE",
            "name": "string"
        }
    ],
    "startActivityId": "bhgu1npktz1coobweefodkb0i",
    "startCondition": [
        {
            "conditionData": "string",
            "type": "string"
        }
    ]
}

The status codes 400, 403, 404, 405, 406, 409, 413, 415, and 500 use the same ApiError JSON error format:

{
    "status": 404,
    "code": "route_not_found",
    "message": "The requested API route does not exist.",
    "details": []
}

Request and response schemas used on this page.