Delete a Workflow Tab

Permanently delete an existing workflow tab from your SysAid account. You cannot undo this action. SysAid also deletes the tab's action items, their dependency links and the rules that fill their fields. If a dependency link joins one of the tab's action items to an action item on another tab, the API returns 409. The workflow must be a Change, Problem or Request template. 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.

integer
required
1 to 2147483647

The unique identifier of the workflow tab in SysAid. GET /workflows/{workflowId} returns the IDs of a workflow's tabs.

Responses
204

The workflow tab was deleted. If service records already use the workflow's tabs, SysAid can first copy the tabs for the workflow. After such a copy, the other tabs have new IDs. If SysAid does not copy the tabs, other templates that use the workflow's sub-type also lose the tab.

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