Ticket

All the endpoints that can be called on the Ticket controller.

Endpoints that require the TICKET_READ permission:

• GET index

• GET item

Endpoints that require the TICKET_CREATE permission:

• POST index

Endpoints that require the TICKET_UPDATE permission:

• PUT item

• POST setPriority

Endpoints that require the TICKET_DELETE permission:

• DELETE item

• DELETE multi

Endpoints that require the SET_STATUS permission:

• POST setStatus

• PUT solveUnfinishedTickets

Endpoints that require the TICKET_BATCH permission:

• POST batch

index

get

Returns all tickets with optional filters such as search queries, views and result limits.

Authorizations

Query parameters

applyViewstring · min: 2Optional

The view to get the tickets from.

Default: ""Pattern: ^[0-9a-zA-Z\-\_]+$

querystring · min: 1OptionalDefault: ""

itemStartnumberOptionalDefault: 0

itemLimitnumber · max: 9999OptionalDefault: 15

searchArchivedstring · enumOptionalDefault: noPossible values:

statusstring · enumOptionalPossible values:

Responses

get

HTTPcURLJavaScriptPython

GET /api/v2/ticket HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Accept: */*

200Success

No content

index

post

Creates a new empty ticket.

Data can be added directly, but also through other /ticket endpoints.

Authorizations

Body

brandIDnumberRequired

channelIDnumberRequired

directionstring · enumRequiredPossible values:

fromstring · min: 2Required

fromNamestring · min: 1OptionalDefault: ""

tostring · min: 2Required

titlestring · min: 2Required

assignedGroupIDnumberOptionalDefault: 0

formIDnumberOptional

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/ticket HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 139

{
  "brandID": 1,
  "channelID": 1,
  "direction": "inbound",
  "from": "text",
  "fromName": "text",
  "to": "text",
  "title": "text",
  "assignedGroupID": 1,
  "formID": 1
}

200Success

No content

item

get

Returns all the data of this ticket.

Authorizations

Path parameters

ticketIDnumberRequired

Query parameters

reloadbooleanOptional

Checks if the ticket is already open. If not, register that it has been opened.

Default: false

getTicketHistorybooleanOptional

Send along this parameter with a value to get the ticket history.

Default: false

Responses

get

HTTPcURLJavaScriptPython

GET /api/v2/ticket/{ticketID} HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Accept: */*

200Success

No content

item

put

Updates the fields of this ticket.

Authorizations

Path parameters

ticketIDnumberRequired

Body

externalPrimaryIDstringOptional

The external primary ID of the customer this ticket belongs to.

titlestringOptional

statusstring · enumOptionalPossible values:

Responses

put

HTTPcURLJavaScriptPython

PUT /api/v2/ticket/{ticketID} HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 57

"externalPrimaryID='text'&title=''&status='solved'"

200Success

No content

item

delete

Deletes all the data of this ticket.

Authorizations

Path parameters

ticketIDnumberRequired

Responses

delete

HTTPcURLJavaScriptPython

DELETE /api/v2/ticket/{ticketID} HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Accept: */*

200Success

No content

multi

delete

Deletes multiple tickets given in an array.

Authorizations

Body

ticketIDsnumber[]Required

Responses

delete

HTTPcURLJavaScriptPython

DELETE /api/v2/ticket/multi HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "ticketIDs": [
    1
  ]
}

200Success

No content

setStatus

post

Sets the status of the tickets given in an array.

Authorizations

Body

statusstring · enumRequiredPossible values:

ticketIDsnumber[]Required

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/ticket/setStatus HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 32

{
  "status": "new",
  "ticketIDs": [
    1
  ]
}

200Success

No content

setPriority

post

Sets the priority of the tickets given in an array.

Authorizations

Body

prioritystring · enumRequiredPossible values:

ticketIDsnumber[]Required

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/ticket/setPriority HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 34

{
  "priority": "low",
  "ticketIDs": [
    1
  ]
}

200Success

No content

unlinkCustomerFromTicket

post

Unlinks the customer from the ticket provided.

Authorizations

Body

ticketIDnumberRequired

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/ticket/unlinkCustomerFromTicket HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 14

{
  "ticketID": 1
}

200Success

No content

batch

post

Performs miscellaneous actions on tickets given in an array.

Authorizations

Body

TicketIDsstringOptional

Can be multiple ID's comma-separated (space allowed).

Pattern: ^[0-9, ]+$

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/ticket/batch HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 69

{
  "TicketIDs": "text",
  "actions": [
    {
      "actionType": "text",
      "value": "text"
    }
  ]
}

200Success

No content