v2

latestOpenAPI 3.0.12026-07-263104131.9 MB
ticketing

Update ticket

Change ticket fields. Does not accept comments

put/v2/ticketing/ticket/{ticketId}

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