Link a Service Record to a Service Record

Link another service record to a specific service record. Both service records must exist and be an incident, change, problem or request, and a service record cannot be linked to itself. The relationship describes the service record in the path towards the related one: 2 = causes, 3 = caused by, 4 = parent, 5 = child, 6 = relates to (the default), 7 = blocks, 8 = blocked by. Linking a pair that is already linked replaces its relationship.

A parent or child link makes the child follow its parent: with 4 (parent) the related service record becomes the child of the one in the path, and with 5 (child) the one in the path becomes the child of the related one, replacing any parent it had. Either way the child's status is overwritten with its parent's status. A link with 4 is refused once the service record in the path has 100 children, and any other link once 50 related items of any kind have been added from the service record in the path; past either limit Ticket Management answers 500. Linking needs permission to edit the service record in the path and to view the related one; a related service record the caller cannot view is answered 404, as one that does not exist.

Path Params
integer
required

The unique identifier of the service record in SysAid.

Body Params
integer
required
1 to 2147483647

The ID of the service record to link to the service record. The caller must be able to view it.

integer
enum
Defaults to 6

How the service record in the path relates to the related one: 2 = causes, 3 = caused by, 4 = parent (the related service record becomes its child), 5 = child (it becomes the related service record's child), 6 = relates to (the default), 7 = blocks, 8 = blocked by. A child's status is overwritten with its parent's.

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