Skip to content

Ticket Related APIs

sanjeev edited this page Apr 6, 2020 · 17 revisions

## For creating a new ticket:

API URL: {helpdesk_url}/api/v1/ticket

Method: [POST]

Authorization: Basic {API token}

Inputs:

message : (your message)

actAsType : (agent/customer)

actAsEmail: (if actASType is agent then specify actAsEmail as agent Email if actAsType is customer then don't need for this parameter)

name: (customer name)

subject: (Ticket subject)

from: (Customer Email)

Optional Inputs:

attachments

## For Adding a Reply or thread:

API URL: {helpdesk_url}/api/v1/ticket/{ticketid}/thread

Method: [POST]

Authorization: Basic {API token}

message: (your reply)

actAsType: (agent/customer)

actAsEmail: (email Id)

threadType: (reply/forword/note)

Optional Inputs:

attachments

## Fetching all Tickets:

API URL: {helpdesk_url}/api/v1/tickets

Method: [GET]

Authorization: Basic {API token}

Optional Inputs:

actAsType: (agent/customer)

actAsEmail: (email Id)


## Moving a ticket into trash:

API URL: {helpdesk_url}/api/v1/trash/ticket/{ticketId}

Method: [PUT]

Authorization: Basic {API token}


## Deleting a ticket permanently or forever (Delete the ticket From trash):

API URL: {helpdesk_url}/api/v1/delete/ticket/{ticketId}

Method: [Delete]

Authorization: Basic {API token}


## Loading a ticket or view ticket:

API URL: {helpdesk_url}/api/v1/ticket/{ticketId}

Method: [GET]

Authorization: Basic {API token}


## Fetching All ticket types:

API URL: {helpdesk_url}/api/v1/ticket-types

Method: [GET]

Authorization: Basic {API token}


## Assigning ticket to a agent:

API URL: {helpdesk_url}/api/v1/ticket/{ticketId}/agent

Method: [PUT]

Authorization: Basic {API token}


## Adding and removing collaborator:

API URL: {helpdesk_url}/api/v1/ticket/{ticketId}/collaborator

Method: [POST, DELETE] (For Adding collaborator Use method Post and for removing use Delete).

Authorization: Basic {API token}

Inputs:

email: Collaborator email when adding a Collaborator.

id : Collaborator Id In case of delete Collaborator action.


## Download ticket attachment:

API URL: {helpdesk_url}/api/v1/ticket/attachment/{attachmentId}

Method: [POST]

Authorization: Basic {API token}


## Download ticket zip attachment:

API URL: {helpdesk_url}/api/v1/ticket/download-zip/{threadId}

Method: [POST]

Authorization: Basic {API token}


## Edit ticket properties:

API URL: {helpdesk_url}/api/v1/ticket/{ticketId}

Method: [PATCH]

Authorization: Basic {API token}

Inputs for agent Update:

property: agent(property is agent)

value: agent Id(agent id)

Inputs for status Update:

property: status(property is status)

value: status Id

Inputs for priority Update:

property: priority(property is priority)

value: priority Id

Inputs for group Update:

property: group(property is group)

value: group Id

Inputs for type Update:

property: type(property is type)

value: type Id

Inputs for label delete:

property: label(property is label)

value: label Id


Clone this wiki locally