Sign in

v2

latestOpenAPI 3.0.12026-07-263104131.9 MB
ticketing

Create ticket

Create a new ticket, does not accept files

post/v2/ticketing/ticket

Request body

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
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

{
  "clientId": 1,
  "ticketFormId": 1,
  "locationId": 1,
  "nodeId": 1,
  "subject": "CPU with problems",
  "description": {
    "body": "new comment",
    "htmlBody": "<p>new comment</p>",
    "timeTracked": 60
  },
  "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