Add ticket links

Links other tickets to a ticket, keeping existing links

Add links to a ticket

post

Adds the given links, keeping every other link on the ticket. Links that already exist are left as they are. Linking requires access to both tickets. At most 20 links per call. Ticket ids may be given in display form, e.g. INC-123.

Authorizations

AuthorizationstringRequired

Harmony access key, sent as Authorization: AccessKey <your-key>. Create keys in Settings > Access Keys. The tenant is resolved from the key.

Path parameters

ticket_idstringRequired

Body

Responses

200

Successful Response

application/json

changedintegerRequired

How many of the requested links were added or removed. Links already as requested are not counted.

422

Validation Error

application/json

post/api/v1/tickets/{ticket_id}/links/add

POST /service-desk/api/v1/tickets/{ticket_id}/links/add HTTP/1.1
Host: api.harmony.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "links": [
    {
      "target_ticket_id": "text",
      "link_type": "duplicate_of"
    }
  ]
}

{
  "changed": 1
}