PATCH Update a Request
URL: {{server-url}}/api/v1/request/{{request-Id}}
You can update the details of an existing request ticket by calling the above endpoint with the request ID. You have to pass the following key-values:
Header
| Key | Description |
|---|---|
| Authorization | Bearer {access token obtained after authorization} |
| Content-Type | application/json |
Body
| Key | Value Type | Description |
|---|---|---|
| subject* | String | Subject of the ticket. |
| categoryName | String | Category Name of a Request. Set to ‘Request’ as it is default to ‘Service Request’. |
| ccEmailSet | String Array | Email Address of People to whom notification is to be sent for certain events on Request. |
| tags | String Array | These are additional identifiers attached to a ticket. It is a list that can contain n number of STRINGS. |
| impactName | String | Describes the effect of the Request. Possible values are: Low, On User , On department, Or On Business. |
| priorityName | String | Shows the importance of the Request. Possible values are: Low, Medium, High, or Urgent. |
| urgencyName | String | Marks the request as urgent. Possible values are: Low, Medium, High, or Urgent. |
| departmentName | String | Additional information about the ticket. |
| locationName | String | Name of the Location where Request happened. Note that Location Must Exist with same name. |
| supportLevel | String | Describes the level of the provisioned support. Possible Values are: Tier1, Tier2, Tier3, or Tier 4. |
| Assignee Email | String | Name of the Assignee. |
| Technician Group Name | String | Name of the group to which the Technician belongs. |
| spam | Boolean | Possible Values are True or False. |
| fileAttachments | Object Array | Reference File Name of attachments for a Request. For example:[ { “refFileName” : “abc”, “realName” : “xyz.pdf” } ] |
| statusName | String | Possible values are Open, In Progress, Pending, Resolved, and Closed. |
| customField | MAP:{key: STRING, value: OBJECT} | This key is related to custom fields. Example “customField”: {“New Dropdown”: “1”, “New Number”: 110.1,”New Text Area”: “a11”, “New Text Input”: “111”} |
Example (Request & Response)
Request
curl --location --request PATCH 'http://172.16.12.136/api/v1/request/81' \
--header 'Authorization: Apikey zecZcdJxeM520YeN%40N6J9RpIPEmGSGCpWskImmuOnGn2ia8Mc0iJ7HMRrJTOM9vIFIfDF7iI90Gz9inI%3D' \
--header 'Content-Type: application/json' \
--data-raw '{
"subject": "Emails are not getting delivered",
"categoryName": "Network",
"ccEmailSet": [
"jerry@motadata.com"
],
"tags": [
"email"
],
"impactName": "On Department",
"priorityName": "High",
"urgencyName": "High",
"departmentName": "IT",
"locationName": "Asia",
"supportLevel": "tier2",
"assigneeEmail": "jerry@motadata.com",
"spam": false,
"customField": {
"New Dependent": "1",
"New Radio": "Yes",
"New Checkbox": [
"a",
"b"
],
"New Number": "123456",
"New Multi-Select Dropdown": [
"a",
"b"
],
"New Dropdown": "1",
"New Text Input": "a",
"New Rich Text Area": "a",
"New Text Area": "a"
}
}'
Response
{
"id": 81,
"categoryName": "Network",
"name": "INC-81",
"createdTime": 1773223973227,
"updatedTime": 1773225714364,
"departmentName": "IT",
"assigneeEmail": "jerry@motadata.com",
"customField": {
"New Checkbox": [
"a",
"b"
],
"IP": "null",
"Device Type": "null",
"New Text Area": "a",
"New Text Input": "a",
"Locationed": "null",
"FollowUpDate": 1763013175000,
"New Dropdown": "1",
"test api 3": "",
"New Number": 123456,
"New Radio": "Yes",
"test api 2": "",
"test api 1": ""
},
"statusName": "Open",
"createdByName": "jerry",
"subject": "Emails are not getting delivered",
"requesterName": "jerry",
"fileAttachments": [],
"requesterEmail": "jerry@example.com",
"description": "",
"tags": [
"email"
],
"locationName": "Asia",
"impactName": "On Department",
"priorityName": "High",
"urgencyName": "High",
"updatedByName": "jerry",
"solutionFileAttachments": [],
"solutionUpdatedTime": 0,
"solutionUpdatedAt": "01/01/1970 05:30 am",
"createdTimeAt": "11/03/2026 03:42 pm",
"updatedTimeAt": "11/03/2026 04:11 pm",
"ccEmailSet": [
"jerry@motadata.com"
],
"source": "External",
"spam": false,
"supportLevel": "tier2",
"diagnosisFileAttachments": [],
"diagnosisUpdatedTime": 0,
"diagnosisUpdatedAt": "01/01/1970 05:30 am"
}