Foxpro / Support API / Merge Tickets into Target Ticket
Back to Collection Items
LOCAL loHttp
LOCAL lnSuccess
LOCAL loJson
LOCAL loResp
LOCAL loSbResponseBody
LOCAL loJResp
LOCAL lnRespStatusCode
LOCAL lcId
LOCAL lcIndex
LOCAL lcId
LOCAL lcMessage
LOCAL lcProgress
LOCAL lcStatus
LOCAL lcTotal
LOCAL lcV_Url
LOCAL i
LOCAL lnCount_i
* This example assumes the Chilkat API to have been previously unlocked.
* See Global Unlock Sample for sample code.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Http')
loHttp = CreateObject('Chilkat.Http')
loHttp.BasicAuth = 1
loHttp.Login = "login"
loHttp.Password = "password"
* Use this online tool to generate code from sample JSON: Generate Code to Create JSON
* The following JSON is sent in the request body.
* {
* "ids": "<array>",
* "source_comment": "<string>",
* "source_comment_is_public": "<boolean>",
* "target_comment": "<string>",
* "target_comment_is_public": "<boolean>"
* }
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("ids","<array>")
loJson.UpdateString("source_comment","<string>")
loJson.UpdateString("source_comment_is_public","<boolean>")
loJson.UpdateString("target_comment","<string>")
loJson.UpdateString("target_comment_is_public","<boolean>")
loHttp.SetRequestHeader("Content-Type","application/json")
loHttp.SetRequestHeader("Accept","application/json")
loResp = loHttp.PostJson3("https://example.zendesk.com/api/v2/tickets/:ticket_id/merge","application/json",loJson)
IF (loHttp.LastMethodSuccess = 0) THEN
? loHttp.LastErrorText
RELEASE loHttp
RELEASE loJson
CANCEL
ENDIF
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbResponseBody = CreateObject('Chilkat.StringBuilder')
loResp.GetBodySb(loSbResponseBody)
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJResp = CreateObject('Chilkat.JsonObject')
loJResp.LoadSb(loSbResponseBody)
loJResp.EmitCompact = 0
? "Response Body:"
? loJResp.Emit()
lnRespStatusCode = loResp.StatusCode
? "Response Status Code = " + STR(lnRespStatusCode)
IF (lnRespStatusCode >= 400) THEN
? "Response Header:"
? loResp.Header
? "Failed."
RELEASE loResp
RELEASE loHttp
RELEASE loJson
RELEASE loSbResponseBody
RELEASE loJResp
CANCEL
ENDIF
RELEASE loResp
* Sample JSON response:
* (Sample code for parsing the JSON response is shown below)
* {
* "job_status": {
* "id": "<string>",
* "message": "<string>",
* "progress": "<integer>",
* "results": [
* {
* "id": "<integer>",
* "index": "<integer>"
* },
* {
* "id": "<integer>",
* "index": "<integer>"
* }
* ],
* "status": "<string>",
* "total": "<integer>",
* "url": "<string>"
* }
* }
* Sample code for parsing the JSON response...
* Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
lcId = loJResp.StringOf("job_status.id")
lcMessage = loJResp.StringOf("job_status.message")
lcProgress = loJResp.StringOf("job_status.progress")
lcStatus = loJResp.StringOf("job_status.status")
lcTotal = loJResp.StringOf("job_status.total")
lcV_Url = loJResp.StringOf("job_status.url")
i = 0
lnCount_i = loJResp.SizeOfArray("job_status.results")
DO WHILE i < lnCount_i
loJResp.I = i
lcId = loJResp.StringOf("job_status.results[i].id")
lcIndex = loJResp.StringOf("job_status.results[i].index")
i = i + 1
ENDDO
RELEASE loHttp
RELEASE loJson
RELEASE loSbResponseBody
RELEASE loJResp
Curl Command
curl -u login:password -X POST
-H "Content-Type: application/json"
-H "Accept: application/json"
-d '{
"ids": "<array>",
"source_comment": "<string>",
"source_comment_is_public": "<boolean>",
"target_comment": "<string>",
"target_comment_is_public": "<boolean>"
}'
https://example.zendesk.com/api/v2/tickets/:ticket_id/merge
Postman Collection Item JSON
{
"name": "Merge Tickets into Target Ticket",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"ids\": \"<array>\",\n \"source_comment\": \"<string>\",\n \"source_comment_is_public\": \"<boolean>\",\n \"target_comment\": \"<string>\",\n \"target_comment_is_public\": \"<boolean>\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v2/tickets/:ticket_id/merge",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"tickets",
":ticket_id",
"merge"
],
"variable": [
{
"key": "ticket_id",
"value": "<integer>"
}
]
},
"description": "Merges one or more tickets into the ticket with the specified id.\n\nSee [Merging tickets](https://support.zendesk.com/hc/en-us/articles/203690916)\nin the Support Help Center for ticket merging rules.\n\nAny attachment to the source ticket is copied to the target ticket.\n\nThis endpoint returns a `job_status` [JSON object](/api-reference/ticketing/ticket-management/job_statuses/#json-format) and queues a background job to do the work.\nUse the [Show Job Status](/api-reference/ticketing/ticket-management/job_statuses/#show-job-status) endpoint to check for the job's completion.\n\n#### Allowed For\n\n* Agents\n\nAgents in the Enterprise account must have merge permissions.\nSee [Creating custom roles and assigning agents (Enterprise)](https://support.zendesk.com/hc/en-us/articles/203662026)\nin the Support Help Center.\n\n#### Available parameters\n\nThe request takes a data object with the following properties:\n\n| Name | Type | Required | Comments |\n| ------------------------ | ------- | -------- | ------------------------------------------------------- |\n| ids | array | yes | Ids of tickets to merge into the target ticket |\n| target_comment | string | no | Private comment to add to the target ticket |\n| source_comment | string | no | Private comment to add to the source ticket |\n| target_comment_is_public | boolean | no | Whether comment in target ticket is public or private |\n| source_comment_is_public | boolean | no | Whether comment in source tickets are public or private |\n\nThe comments are optional but strongly recommended.\n\nComments are private and can't be modified in the following cases:\n\n * Any of the sources or target tickets are private\n * Any of the sources or target tickets were created through Twitter, Facebook or the Channel framework\n\nIn any other case, comments default to private but can be modified with the comment privacy parameters."
},
"response": [
{
"name": "Successful response",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: basic",
"key": "Authorization",
"value": "Basic <credentials>"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"ids\": \"<array>\",\n \"source_comment\": \"<string>\",\n \"source_comment_is_public\": \"<boolean>\",\n \"target_comment\": \"<string>\",\n \"target_comment_is_public\": \"<boolean>\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v2/tickets/:ticket_id/merge",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"tickets",
":ticket_id",
"merge"
],
"variable": [
{
"key": "ticket_id"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"job_status\": {\n \"id\": \"<string>\",\n \"message\": \"<string>\",\n \"progress\": \"<integer>\",\n \"results\": [\n {\n \"id\": \"<integer>\",\n \"index\": \"<integer>\"\n },\n {\n \"id\": \"<integer>\",\n \"index\": \"<integer>\"\n }\n ],\n \"status\": \"<string>\",\n \"total\": \"<integer>\",\n \"url\": \"<string>\"\n }\n}"
}
]
}
