Create a Workflow Dependency

Create a new dependency link between two action items of a workflow in your SysAid account. The workflow must be a Change, Problem or Request template. SysAid uses the new link only in the service records that it creates from the template after this change. If the API returns 500 or 502, read the dependencies before you try again, because SysAid can have created the link. The calling user needs the permission to design workflows.

Path Params
integer
required
1 to 2147483647

The unique identifier of the workflow in SysAid. It is the ID of the SysAid service record that holds the workflow. For a Change, Problem or Request template, this service record is the template's workflow record. For the templates that SysAid ships, this record has the template's ID. A Change, Problem or Request service record holds its own copy of its template's workflow. The read operations also accept the ID of such a service record. If no workflow exists with this ID, for example for the ID of an Incident, the API returns 404.

Body Params

The dependency link to create. The link must point forward, from an earlier tab or from higher on the same tab. If the link points backward, the API returns 400. If a link from the source action item to the target action item already exists, the API returns 409. To change the type of a link, delete the link and create it again. The link must not close a loop through the other links of the workflow.

integer
required
1 to 2147483647

The unique identifier of the action item that the target action item waits for. Use GET /workflows/{workflowId} to retrieve the action items of the workflow.

integer
required
1 to 2147483647

The unique identifier of the action item that waits for the source action item. Use GET /workflows/{workflowId} to retrieve the action items of the workflow.

string
enum
Defaults to finish-to-start

Whether the target action item waits for the source to be completed ("finish-to-start") or to become active ("start-to-start"). The default type is "finish-to-start".

Allowed:
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json