Skip to main content

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

KeyDescription
AuthorizationBearer {access token obtained after authorization}
Content-Typeapplication/json

Body

KeyValue TypeDescription
subject*StringSubject of the ticket.
categoryNameStringCategory Name of a Request. Set to ‘Request’ as it is default to ‘Service Request’.
ccEmailSetString ArrayEmail Address of People to whom notification is to be sent for certain events on Request.
tagsString ArrayThese are additional identifiers attached to a ticket. It is a list that can contain n number of STRINGS.
impactNameStringDescribes the effect of the Request. Possible values are: Low, On User , On department, Or On Business.
priorityNameStringShows the importance of the Request. Possible values are: Low, Medium, High, or Urgent.
urgencyNameStringMarks the request as urgent. Possible values are: Low, Medium, High, or Urgent.
departmentNameStringAdditional information about the ticket.
locationNameStringName of the Location where Request happened. Note that Location Must Exist with same name.
supportLevelStringDescribes the level of the provisioned support. Possible Values are: Tier1, Tier2, Tier3, or Tier 4.
Assignee EmailStringName of the Assignee.
Technician Group NameStringName of the group to which the Technician belongs.
spamBooleanPossible Values are True or False.
fileAttachmentsObject ArrayReference File Name of attachments for a Request. For example:[ { “refFileName” : “abc”, “realName” : “xyz.pdf” } ]
statusNameStringPossible values are Open, In Progress, Pending, Resolved, and Closed.
customFieldMAP:{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"
}