Add a linked ticket

This method allows you to link a ticket with another ticket in your Sirportly account.

URL

/api/v2/tickets/link_ticket

Access

This method can be accessed by account tokens and user tokens where the associated user has access to the tickets UI.

Supported Parameters

  • ticket - the reference of the ticket you wish to add a linked ticket to (required)
  • link_to - the reference of the ticket that you're linking to (required)
  • actor - the username or ID of the user who is making this link (required unless authenticating with a user token, in which case the follow up will always be associated with the token's user).

Returned Data

If the follow up is added successfully, you will receive a 201 Created response with details about the ticket you have just added a linked ticket to. If a validation error occurs, you will receive a 422 Unprocessable Entity status along with an array of errors (see below).

Example JSON

A successful request

{
  "id": 2,
  "reference": "OC-820409",
  "subject": "Re: Your Codebase account at myaccount.codebasehq.com is due for renewal",
  ...
  "linked_tickets": [
    "K-2SO", 
  ]
}

A failed request

{
  "errors": {
    "base": [
      "Cannot link a ticket to itself"
    ]
  }
}

Proudly powered by Katapult. Running on 100% renewable energy.