ticketing

Change ticket fields. Does not accept comments

put/v2/ticketing/ticket/{ticketId}

Request

Path parameters

ticketIdinteger required

Request body

versioninteger required

ticket version

clientIdinteger required

Client (Organization) identifier

ticketFormIdinteger required

Ticket form identifier

locationIdinteger nullable

Location identifier

nodeIdinteger nullable

Device identifier

subjectstring required
statusstring required
type'PROBLEM' | 'QUESTION' | 'INCIDENT' | 'TASK' | 'CHANGE_REQUEST' | 'SERVICE_REQUEST' | 'PROJECT' | 'APPOINTMENT' | 'MISCELLANEOUS' nullable

Type of ticket

assignedAppUserIdinteger nullable
requesterUidstring uuid required
severity'NONE' | 'MINOR' | 'MODERATE' | 'MAJOR' | 'CRITICAL' nullable
priority'NONE' | 'LOW' | 'MEDIUM' | 'HIGH' nullable
parentTicketIdinteger nullable

Ticket parent identifier

tagsstring[] nullable
additionalAssignedTechnicianIdsinteger[] nullable

Additional assigned technician identifiers

followupTimenumber double nullable

Follow-up time for the ticket in epoch seconds

Example request

{
  "version": 1,
  "clientId": 1,
  "ticketFormId": 1,
  "locationId": 1,
  "nodeId": 1,
  "subject": "CPU with problems",
  "type": "PROBLEM",
  "cc": {
    "uids": [
      "1fa74a18-a329-40d8-b5b7-0a22624f7800",
      "b0558cb6-3c4e-438c-b8fd-5247c648bbbe"
    ],
    "emails": [
      "example1@example.com",
      "example2@example.com"
    ]
  },
  "parentTicketId": 1,
  "tags": [
    "tag1",
    "tag2"
  ],
  "attributes": [
    {
      "id": 1,
      "attributeId": 1
    }
  ],
  "additionalAssignedTechnicianIds": [
    300,
    789
  ]
}

Response

default response

idinteger
versioninteger
nodeIdinteger
clientIdinteger
locationIdinteger
assignedAppUserIdinteger
requesterUidstring uuid
subjectstring
type'PROBLEM' | 'QUESTION' | 'INCIDENT' | 'TASK' | 'CHANGE_REQUEST' | 'SERVICE_REQUEST' | 'PROJECT' | 'APPOINTMENT' | 'MISCELLANEOUS'
priority'NONE' | 'LOW' | 'MEDIUM' | 'HIGH'
severity'NONE' | 'MINOR' | 'MODERATE' | 'MAJOR' | 'CRITICAL'
ticketFormIdinteger
source'TECHNICIAN' | 'EMAIL' | 'WEB_FORM' | 'HELP_REQUEST' | 'END_USER' | 'CONDITION' | 'SCHEDULED_SCRIPT' | 'ACTIVITY'
tagsstring[]
createTimenumber double
deletedboolean
additionalAssignedTechnicianIdsinteger[]
followupTimenumber double

Changes

    • info

      api operation id update_1 removed and replaced with update_2

    • warning

      added the new APPOINTMENT enum value to the response property for the response status

    • warning

      added the new CHANGE_REQUEST enum value to the response property for the response status

    • warning

      added the new MISCELLANEOUS enum value to the response property for the response status

    • warning

      added the new PROJECT enum value to the response property for the response status

    • warning

      added the new SERVICE_REQUEST enum value to the response property for the response status

    • info

      api operation id update removed and replaced with update_1

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new APPOINTMENT enum value to the request property

    • info

      added the new CHANGE_REQUEST enum value to the request property

    • info

      added the new MISCELLANEOUS enum value to the request property

    • info

      added the new PROJECT enum value to the request property

    • info

      added the new SERVICE_REQUEST enum value to the request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status