PUT/tickets/:id/

Update ticket

You can update a specific ticket.

Attributes	Type	Required	Description
custom_id	string	no	The unique identifier for the ticket which is provided by the client.
id	integer	yes	A unique identifier for the ticket which is given by User.com automatically.
assigned_to	integer	no	A unique identifier for the agent which is given by User.com automatically.
attachments	object	no	An attachment for a ticket (gif, jpg, pdf).
company_id	integer	no	A unique identifier for the company which is given by User.com automatically.
description	string	yes	A ticket description.
due_date	string	no	A date in the future by which the task should be completed. Compliance with ISO 8601 standard format.
name	string	yes	A ticket name.
participants	integer	no	A list of users' ids.
priority	integer	no	A priority of your ticket.
status	string	no	A current status of the ticket (draft, active, closed or archived).
user_id	integer	no	A unique identifier for the user which is given by User.com automatically.

Request

CURL

  curl -X PUT
    "https://<your_app_subdomain>.user.com/api/public/tickets/"
    -H 'Authorization: Token <your_64_char_api_key>'
    -H 'Content-Type: application/json'
    -d '{
      "name": "New Ticket",
      "custom_id": "new-ticket",
      "description": "Example from REST API",
      "status": "draft",
      "due_date": "2020-11-25T00:00:00Z",
      "assigned_to": 1,
      "person": 123,
      "company": 42,
      "participants": [1, 2, 3],
      "priority": 1
  }'

JavaScript

var data = JSON.stringify({
  "name": "New Ticket",
  "custom_id": "new-ticket",
  "description": "Example from REST API",
  "status": "draft",
  "due_date": "2020-11-25T00:00:00Z",
  "assigned_to": 1,
  "person": 123,
  "company": 42,
  "participants": [1, 2, 3],
  "priority": 1}"

});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("PUT", "https://<your_app_subdomain>.user.com/api/public/tickets/");
xhr.setRequestHeader("authorization", "Token <your_64_char_api_key>");
xhr.setRequestHeader("accept", "*/*; version=2");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

PHP

  <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_PORT => "8000",
      CURLOPT_URL => "https://<your_app_subdomain>.user.com/api/public/tickets/",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 30,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "PUT",
      CURLOPT_POSTFIELDS => "{\n\t\"name\": \"my ticket\",\n\t\"custom_id\": \"my custom id\",\n\t\"status\": \"draft\",\n\t\"token\": \"some-token\",\n\t\"description\": \"my description\",\n\t\"due_date\": \"2019-12-20T12:25:05.555624Z\",\n\t\"closed_at\": \"2019-12-20T12:25:05.555624Z\",\n\t\"priority\": 1,\n\t\"assigned_to\": 1,\n\t\"company\": 1\n}",  CURLOPT_HTTPHEADER => array(
      "Accept: */*; version=2",
        "Authorization: Token \<your_64_char_api_key>",
        "Content-Type: application/json",
        "Postman-Token: 4536e8ad-8801-4f25-80bb-aaa1343642ee",
        "cache-control: no-cache"
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    curl_close($curl);
    
    if ($err) {
      echo "cURL Error #:" . $err;
    } else {
      echo $response;
    }

Python

import requests
    
  url = "https://<your_app_subdomain>.user.com/api/public/tickets/"
  
  payload = "{
      "name": "New Ticket",
      "custom_id": "new-ticket",
      "description": "Example from REST API",
      "status": "draft",
      "due_date": "2020-11-25T00:00:00Z",
      "assigned_to": 1,
      "person": 123,
      "company": 42,
      "participants": [1, 2, 3],
      "priority": 1
  }"
  headers = {
      'Authorization': "Token YxMAaMr0ly4VtE5nvQdzxtALSLnHDWtUuvx4FI54oWnQEgJmJ088kktucqMAmfwD",
      'Content-Type': "application/json",
      'cache-control': "no-cache",
      'Postman-Token': "c82439d4-21c5-4e5d-9747-fa1a7525667c"
      }
  
  response = requests.request("PUT", url, data=payload, headers=headers)
  
  print(response.text)

Response

  {
      "name": "New Ticket",
      "custom_id": "new-ticket",
      "description": "Example from REST API",
      "status": "draft",
      "due_date": "2020-11-25T00:00:00Z",
      "assigned_to": 1,
      "person": 123,
      "company": 42,
      "participants": [1, 2, 3],
      "priority": 1
  }