Add a linked ticket

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




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 is due for renewal",
  "linked_tickets": [

A failed request

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

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