Update ticket

Update ticket

curl --request PATCH \
  --url https://api.helpdesk.com/v1/tickets/{ticketID} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "author": {
    "type": "client"
  },
  "status": "open",
  "spam": true,
  "subject": "Ticket subject",
  "priority": -10,
  "teamIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "requester": {
    "email": "requester@email.com",
    "name": "John Client"
  },
  "cc": [
    {
      "email": "cc@email.com",
      "name": "John Client"
    }
  ],
  "tagIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "followers": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "assignment": {
    "team": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c"
    },
    "agent": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c"
    }
  },
  "message": {
    "text": "Hello from a ticket!",
    "cannedResponseIDs": [
      "42e113f9-9353-4e89-9f68-69b92f423b0c"
    ]
  },
  "isPrivate": true,
  "transactionID": "050340e4-82de-4a2a-a1c4-724dfaf66cec",
  "customFields": {
    "order-id": "1234"
  },
  "actions": {
    "list": [
      {
        "type": "assign",
        "teamID": "5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b",
        "randomAgent": true,
        "roundRobin": true,
        "agentID": "5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b"
      }
    ],
    "macroIDs": [
      "42e113f9-9353-4e89-9f68-69b92f423b0c"
    ]
  }
}
'

import requests

url = "https://api.helpdesk.com/v1/tickets/{ticketID}"

payload = {
    "author": { "type": "client" },
    "status": "open",
    "spam": True,
    "subject": "Ticket subject",
    "priority": -10,
    "teamIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "requester": {
        "email": "requester@email.com",
        "name": "John Client"
    },
    "cc": [
        {
            "email": "cc@email.com",
            "name": "John Client"
        }
    ],
    "tagIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "followers": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "assignment": {
        "team": { "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c" },
        "agent": { "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c" }
    },
    "message": {
        "text": "Hello from a ticket!",
        "cannedResponseIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"]
    },
    "isPrivate": True,
    "transactionID": "050340e4-82de-4a2a-a1c4-724dfaf66cec",
    "customFields": { "order-id": "1234" },
    "actions": {
        "list": [
            {
                "type": "assign",
                "teamID": "5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b",
                "randomAgent": True,
                "roundRobin": True,
                "agentID": "5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b"
            }
        ],
        "macroIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"]
    }
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    author: {type: 'client'},
    status: 'open',
    spam: true,
    subject: 'Ticket subject',
    priority: -10,
    teamIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    requester: {email: 'requester@email.com', name: 'John Client'},
    cc: [{email: 'cc@email.com', name: 'John Client'}],
    tagIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    followers: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    assignment: {
      team: {ID: '42e113f9-9353-4e89-9f68-69b92f423b0c'},
      agent: {ID: '42e113f9-9353-4e89-9f68-69b92f423b0c'}
    },
    message: {
      text: 'Hello from a ticket!',
      cannedResponseIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c']
    },
    isPrivate: true,
    transactionID: '050340e4-82de-4a2a-a1c4-724dfaf66cec',
    customFields: {'order-id': '1234'},
    actions: {
      list: [
        {
          type: 'assign',
          teamID: '5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b',
          randomAgent: true,
          roundRobin: true,
          agentID: '5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b'
        }
      ],
      macroIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c']
    }
  })
};

fetch('https://api.helpdesk.com/v1/tickets/{ticketID}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.helpdesk.com/v1/tickets/{ticketID}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'author' => [
        'type' => 'client'
    ],
    'status' => 'open',
    'spam' => true,
    'subject' => 'Ticket subject',
    'priority' => -10,
    'teamIDs' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'requester' => [
        'email' => 'requester@email.com',
        'name' => 'John Client'
    ],
    'cc' => [
        [
                'email' => 'cc@email.com',
                'name' => 'John Client'
        ]
    ],
    'tagIDs' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'followers' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'assignment' => [
        'team' => [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ],
        'agent' => [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ],
    'message' => [
        'text' => 'Hello from a ticket!',
        'cannedResponseIDs' => [
                '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ],
    'isPrivate' => true,
    'transactionID' => '050340e4-82de-4a2a-a1c4-724dfaf66cec',
    'customFields' => [
        'order-id' => '1234'
    ],
    'actions' => [
        'list' => [
                [
                                'type' => 'assign',
                                'teamID' => '5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b',
                                'randomAgent' => true,
                                'roundRobin' => true,
                                'agentID' => '5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b'
                ]
        ],
        'macroIDs' => [
                '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.helpdesk.com/v1/tickets/{ticketID}"

	payload := strings.NewReader("{\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"status\": \"open\",\n  \"spam\": true,\n  \"subject\": \"Ticket subject\",\n  \"priority\": -10,\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\",\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"actions\": {\n    \"list\": [\n      {\n        \"type\": \"assign\",\n        \"teamID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\",\n        \"randomAgent\": true,\n        \"roundRobin\": true,\n        \"agentID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\"\n      }\n    ],\n    \"macroIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.helpdesk.com/v1/tickets/{ticketID}")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"status\": \"open\",\n  \"spam\": true,\n  \"subject\": \"Ticket subject\",\n  \"priority\": -10,\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\",\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"actions\": {\n    \"list\": [\n      {\n        \"type\": \"assign\",\n        \"teamID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\",\n        \"randomAgent\": true,\n        \"roundRobin\": true,\n        \"agentID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\"\n      }\n    ],\n    \"macroIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.helpdesk.com/v1/tickets/{ticketID}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"status\": \"open\",\n  \"spam\": true,\n  \"subject\": \"Ticket subject\",\n  \"priority\": -10,\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\",\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"actions\": {\n    \"list\": [\n      {\n        \"type\": \"assign\",\n        \"teamID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\",\n        \"randomAgent\": true,\n        \"roundRobin\": true,\n        \"agentID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\"\n      }\n    ],\n    \"macroIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
  "licenseID": 13381337,
  "createdAt": "2026-06-30T22:02:08.901Z",
  "createdBy": "f56caf69-3f05-4386-9567-fdc909d7ad77",
  "createdByType": "agent",
  "updatedAt": "2026-06-30T22:02:08.901Z",
  "updatedBy": "f56caf69-3f05-4386-9567-fdc909d7ad77",
  "shortID": "IIPZGJ",
  "lastMessageAt": "2026-06-30T22:02:08.901Z",
  "parentTicket": {
    "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
    "shortID": "IIPZGJ",
    "subject": "Parent ticket subject"
  },
  "childTickets": [
    {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "shortID": "IIPZGJ",
      "subject": "Child ticket subject"
    }
  ],
  "status": "open",
  "priority": -10,
  "subject": "Ticket subject",
  "teamIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "requester": {
    "email": "",
    "name": ""
  },
  "cc": [
    {
      "email": "cc@email.com",
      "name": "John Client"
    }
  ],
  "tagIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "followers": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "assignment": {
    "team": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "name": ""
    },
    "agent": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "name": ""
    }
  },
  "integration": {
    "type": "livechat",
    "referenceType": "",
    "referenceURL": "",
    "referenceID": ""
  },
  "customFields": {
    "order-id": "1234"
  },
  "ratingRequeestSent": true,
  "rating": {
    "rate": "good",
    "comment": "",
    "requestedAt": "2026-06-30T22:02:08.901Z"
  },
  "silo": "tickets",
  "spam": {
    "status": true,
    "reason": "licenseBlackList"
  },
  "source": {
    "type": "api"
  },
  "events": [
    {
      "type": "message"
    }
  ],
  "integrations": {
    "type": "livechat",
    "externalID": ""
  },
  "detectedLanguage": ""
}

PATCH

tickets

{ticketID}

Update ticket

curl --request PATCH \
  --url https://api.helpdesk.com/v1/tickets/{ticketID} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "author": {
    "type": "client"
  },
  "status": "open",
  "spam": true,
  "subject": "Ticket subject",
  "priority": -10,
  "teamIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "requester": {
    "email": "requester@email.com",
    "name": "John Client"
  },
  "cc": [
    {
      "email": "cc@email.com",
      "name": "John Client"
    }
  ],
  "tagIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "followers": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "assignment": {
    "team": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c"
    },
    "agent": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c"
    }
  },
  "message": {
    "text": "Hello from a ticket!",
    "cannedResponseIDs": [
      "42e113f9-9353-4e89-9f68-69b92f423b0c"
    ]
  },
  "isPrivate": true,
  "transactionID": "050340e4-82de-4a2a-a1c4-724dfaf66cec",
  "customFields": {
    "order-id": "1234"
  },
  "actions": {
    "list": [
      {
        "type": "assign",
        "teamID": "5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b",
        "randomAgent": true,
        "roundRobin": true,
        "agentID": "5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b"
      }
    ],
    "macroIDs": [
      "42e113f9-9353-4e89-9f68-69b92f423b0c"
    ]
  }
}
'

import requests

url = "https://api.helpdesk.com/v1/tickets/{ticketID}"

payload = {
    "author": { "type": "client" },
    "status": "open",
    "spam": True,
    "subject": "Ticket subject",
    "priority": -10,
    "teamIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "requester": {
        "email": "requester@email.com",
        "name": "John Client"
    },
    "cc": [
        {
            "email": "cc@email.com",
            "name": "John Client"
        }
    ],
    "tagIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "followers": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "assignment": {
        "team": { "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c" },
        "agent": { "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c" }
    },
    "message": {
        "text": "Hello from a ticket!",
        "cannedResponseIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"]
    },
    "isPrivate": True,
    "transactionID": "050340e4-82de-4a2a-a1c4-724dfaf66cec",
    "customFields": { "order-id": "1234" },
    "actions": {
        "list": [
            {
                "type": "assign",
                "teamID": "5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b",
                "randomAgent": True,
                "roundRobin": True,
                "agentID": "5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b"
            }
        ],
        "macroIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"]
    }
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    author: {type: 'client'},
    status: 'open',
    spam: true,
    subject: 'Ticket subject',
    priority: -10,
    teamIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    requester: {email: 'requester@email.com', name: 'John Client'},
    cc: [{email: 'cc@email.com', name: 'John Client'}],
    tagIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    followers: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    assignment: {
      team: {ID: '42e113f9-9353-4e89-9f68-69b92f423b0c'},
      agent: {ID: '42e113f9-9353-4e89-9f68-69b92f423b0c'}
    },
    message: {
      text: 'Hello from a ticket!',
      cannedResponseIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c']
    },
    isPrivate: true,
    transactionID: '050340e4-82de-4a2a-a1c4-724dfaf66cec',
    customFields: {'order-id': '1234'},
    actions: {
      list: [
        {
          type: 'assign',
          teamID: '5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b',
          randomAgent: true,
          roundRobin: true,
          agentID: '5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b'
        }
      ],
      macroIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c']
    }
  })
};

fetch('https://api.helpdesk.com/v1/tickets/{ticketID}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.helpdesk.com/v1/tickets/{ticketID}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'author' => [
        'type' => 'client'
    ],
    'status' => 'open',
    'spam' => true,
    'subject' => 'Ticket subject',
    'priority' => -10,
    'teamIDs' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'requester' => [
        'email' => 'requester@email.com',
        'name' => 'John Client'
    ],
    'cc' => [
        [
                'email' => 'cc@email.com',
                'name' => 'John Client'
        ]
    ],
    'tagIDs' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'followers' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'assignment' => [
        'team' => [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ],
        'agent' => [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ],
    'message' => [
        'text' => 'Hello from a ticket!',
        'cannedResponseIDs' => [
                '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ],
    'isPrivate' => true,
    'transactionID' => '050340e4-82de-4a2a-a1c4-724dfaf66cec',
    'customFields' => [
        'order-id' => '1234'
    ],
    'actions' => [
        'list' => [
                [
                                'type' => 'assign',
                                'teamID' => '5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b',
                                'randomAgent' => true,
                                'roundRobin' => true,
                                'agentID' => '5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b'
                ]
        ],
        'macroIDs' => [
                '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.helpdesk.com/v1/tickets/{ticketID}"

	payload := strings.NewReader("{\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"status\": \"open\",\n  \"spam\": true,\n  \"subject\": \"Ticket subject\",\n  \"priority\": -10,\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\",\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"actions\": {\n    \"list\": [\n      {\n        \"type\": \"assign\",\n        \"teamID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\",\n        \"randomAgent\": true,\n        \"roundRobin\": true,\n        \"agentID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\"\n      }\n    ],\n    \"macroIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.helpdesk.com/v1/tickets/{ticketID}")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"status\": \"open\",\n  \"spam\": true,\n  \"subject\": \"Ticket subject\",\n  \"priority\": -10,\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\",\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"actions\": {\n    \"list\": [\n      {\n        \"type\": \"assign\",\n        \"teamID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\",\n        \"randomAgent\": true,\n        \"roundRobin\": true,\n        \"agentID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\"\n      }\n    ],\n    \"macroIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.helpdesk.com/v1/tickets/{ticketID}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"status\": \"open\",\n  \"spam\": true,\n  \"subject\": \"Ticket subject\",\n  \"priority\": -10,\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\",\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"actions\": {\n    \"list\": [\n      {\n        \"type\": \"assign\",\n        \"teamID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\",\n        \"randomAgent\": true,\n        \"roundRobin\": true,\n        \"agentID\": \"5f4b1f3b-4b7b-4b7b-8b7b-4b7b4b7b4b7b\"\n      }\n    ],\n    \"macroIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
  "licenseID": 13381337,
  "createdAt": "2026-06-30T22:02:08.901Z",
  "createdBy": "f56caf69-3f05-4386-9567-fdc909d7ad77",
  "createdByType": "agent",
  "updatedAt": "2026-06-30T22:02:08.901Z",
  "updatedBy": "f56caf69-3f05-4386-9567-fdc909d7ad77",
  "shortID": "IIPZGJ",
  "lastMessageAt": "2026-06-30T22:02:08.901Z",
  "parentTicket": {
    "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
    "shortID": "IIPZGJ",
    "subject": "Parent ticket subject"
  },
  "childTickets": [
    {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "shortID": "IIPZGJ",
      "subject": "Child ticket subject"
    }
  ],
  "status": "open",
  "priority": -10,
  "subject": "Ticket subject",
  "teamIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "requester": {
    "email": "",
    "name": ""
  },
  "cc": [
    {
      "email": "cc@email.com",
      "name": "John Client"
    }
  ],
  "tagIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "followers": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "assignment": {
    "team": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "name": ""
    },
    "agent": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "name": ""
    }
  },
  "integration": {
    "type": "livechat",
    "referenceType": "",
    "referenceURL": "",
    "referenceID": ""
  },
  "customFields": {
    "order-id": "1234"
  },
  "ratingRequeestSent": true,
  "rating": {
    "rate": "good",
    "comment": "",
    "requestedAt": "2026-06-30T22:02:08.901Z"
  },
  "silo": "tickets",
  "spam": {
    "status": true,
    "reason": "licenseBlackList"
  },
  "source": {
    "type": "api"
  },
  "events": [
    {
      "type": "message"
    }
  ],
  "integrations": {
    "type": "livechat",
    "externalID": ""
  },
  "detectedLanguage": ""
}

Authorizations

Authorization

string

header

required

Use your account ID as the username and your personal access token (PAT) as the password, or pass a Base64-encoded value directly in the Authorization header. For more information, see the personal access tokens guide.

Path Parameters

ticketID

string<uuid>

required

Unique object identifier

Example:

"42e113f9-9353-4e89-9f68-69b92f423b0c"

Body

application/json

author

object

Show child attributes

status

enum<string>

default:open

Ticket status

Available options:

open,

pending,

onhold,

solved,

closed

spam

boolean

Is ticket a spam ticket.

subject

string

Example:

"Ticket subject"

priority

enum<integer>

default:0

Value	Priority
-10	low
0	medium
10	high
20	urgent

Available options:

-10,

0,

10,

20

teamIDs

string<uuid>[]

Teams that can access the ticket

Unique object identifier

requester

object

Show child attributes

object[]

List of people in the loop

Show child attributes

tagIDs

string<uuid>[]

List of ticket tags

Unique object identifier

followers

string<uuid>[]

List of ticket followers (agents)

Unique object identifier

assignment

object

Team / agent assignment

Show child attributes

message

object

Add new message to the ticket

Option 1
Option 2

Show child attributes

isPrivate

boolean

default:false

Is the new message a private message.

transactionID

string<uuid>

References transaction containing uploaded attachments used in ticket's message content.

customFields

object

Object with custom fields values, where key is custom fields apiKey.

Example:

{ "order-id": "1234" }

actions

object

Apply actions to the ticket.

Show child attributes

Response

200 - application/json

Successful response.

string<uuid>

Unique object identifier.

licenseID

integer

Unique account identifier.

createdAt

string<date-time>

The time of creation.

createdBy

string<uuid>

The creator identifier.

createdByType

enum<string>

The creator type.

Available options:

agent,

client,

system

updatedAt

string<date-time>

The time of last modification.

updatedBy

string<uuid>

The modification author identifier.

shortID

string

The short ticket ID.

lastMessageAt

string<date-time>

The time of last public message.

parentTicket

object | null

The parent ticket reference.

Show child attributes

childTickets

object[]

The merged ticket reference.

Show child attributes

status

enum<string>

default:open

Ticket status

Available options:

open,

pending,

onhold,

solved,

closed

priority

enum<integer>

default:0

Value	Priority
-10	low
0	medium
10	high
20	urgent

Available options:

-10,

0,

10,

20

subject

string

teamIDs

string<uuid>[]

The teams that can access the ticket.

Unique object identifier

requester

object

Ticket requester

Show child attributes

object[]

A list of people in the loop.

Show child attributes

tagIDs

string<uuid>[]

A list of ticket tags.

Unique object identifier

followers

string<uuid>[]

A list of ticket followers (agents).

Unique object identifier

assignment

object

Team / agent assignment

Show child attributes

integration

object

Show child attributes

customFields

object

Object with custom fields values, where key is custom fields apiKey.

Example:

{ "order-id": "1234" }

ratingRequeestSent

boolean

default:false

Has rating request been sent.

rating

object | null

Ticket rating

Show child attributes

silo

enum<string>

default:tickets

Ticket silo (folder). Please check ticket silos section for more information

Available options:

tickets,

archive,

trash,

spam

spam

object

Show child attributes

source

object

Option 1
Option 2
Option 3
Option 4

Show child attributes

events

object[]

The ticket events.

Show child attributes

integrations

object

Option 1
Option 2

Show child attributes

detectedLanguage

string

The detected language code.

Delete ticket

Add tag

Agents

Canned responses

Custom fields

Email domains

Mailboxes (inboxes)

Licenses

Reply addresses

Reports

Rules

Macros

Spam management

Tags

Teams

Templates

Audit log

Tickets

Transactions

Views

Webhooks

Imported tickets

Authorizations

Path Parameters

Body

Response