Skip to main content
Version: 8.4

Technician Rest API

The page provides the APIs related to the technician.

Date format : dd-MM-yyyy HH:mm

Field NameField TypeField Applicable ForDetail Specification
nameStringTechnician, RequesterName of user.
emailStringTechnician, RequesterEmail of user.
departmentNameStringTechnician, Requester
locationNameStringTechnician, Requester
rolesString ArrayTechnicianUser Roles
accessLevelStringTechnicianUser Access Level , Possible Values: global_access, group_access, restricted.
contactNoStringTechnician, Requester
altContactNo1StringTechnician, Requester
altContactNo2StringTechnician, Requester
supportLevelStringTechnicianDescribes the level of the provisioned support. Possible Values: Tier1, Tier2, Tier3, or Tier 4.
userLogOnNameStringTechnician, RequesterUser Log On Name
verifiedBooleanTechnician, RequesterOnly For Get API
vipRequesterBooleanRequester
customFieldKey-Value PairTechnician, Requester

Get Technician

URL: http://{{server-url}}/api/v1/technician/4

Request

curl --location 'https://172.16.12.135/api/v1/technician/1' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dpbl9zc29faWQiOjAsInVzZXJfbmFtZSI6ImpvaG5AbW90YWRhdGEuY29tIiwic2NvcGUiOlsib3RoZXItYXBpLXNjb3BlIl0sImxvZ2luX3NvdXJjZSI6Im5vcm1hbF9sb2dpbiIsImV4cCI6MTY4NjEzNzQ4NywibG9naW5fbXNwX3BvcnRhbF9pZCI6MCwianRpIjoiOGExMDc1MTEtY2YzMC00ODcxLWIzZmQtZjY1NmJhNDUyZTRiIiwiY2xpZW50X2lkIjoiUG9zdG1hbkludGVncmF0aW9uLWNsaWVudCIsInRlbmFudElkZW50aWZpZXIiOiJhcG9sbyJ9.RJg1Xb7rVs6s-H6qItcZmwkLAaV95AgbaY813PTn4U7fDz7GV0gpVsMgWAcHOnSV9J-KGsdyw2vHf4rIfH3h8dt3SrJq8B7TPpMNoccXCarBEIGxxMHAKxs9cPcuw7cNY2K5NtfKj8voRl0vRzBHxuQS8h7J6hYnLcOFIMK6B-hZQKBbYL7lgOY86l22ghjcyY9pzwaxjNgtD922f3ru998Vyh_shJOiIb12QEqYxXzle-hxrOkB4hF_KVoNXi0w3WhO09i_aOX16eAfYo2neXd-hZ2TyFqQsKGNy83ZDkwCeeV2Y6Yxck_tMTBVrH6YaAc4NDtEHpA591vImBWtwg'

Response

{
"id": 1,
"email": "john@motadata.com",
"roles": [
"Super Admin"
],
"accessLevel": "global_access",
"contactNo": "123123123",
"supportLevel": [],
"allowToLogin": true,
"verified": true,
"isBlock": false,
"block": false,
"name": "john"
}

Post Create Technician

Create (Post Method) : http://{{server-url}}/api/v1/technician

Request

curl --location --request POST 'http://172.16.8.220/api/v1/technician' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJoYXJzaC5iaGF0aWFAbW90YWRhdGEuY29tIiwic2NvcGUiOlsib3RoZXItYXBpLXNjb3BlIl0sImxvZ2luX3NvdXJjZSI6Im5vcm1hbF9sb2dpbiIsImV4cCI6MTYwMzI1NTI5MiwianRpIjoiOTNlNDQ1MGMtNjBhZC00NjE0LTg5OTItOTU1OWIxZWUwYTM1IiwiY2xpZW50X2lkIjoiSEItY2xpZW50IiwidGVuYW50SWRlbnRpZmllciI6ImFwb2xvIn0.QOvpxH8Vde9EZbPjbTTtdMUS9sR7Xk8KMTjZYg3HPm4' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Harsh Bhatia",
"email": "harsh.bhatia1@motadata.com",
"userLogOnName": "Logon101",
"contactNo": "8905063002",
"locationName": "Asia",
"departmentName": "HR",
"manager": "raghav.bhatia@motadata.com",
"altContactNo1":"7816093148",
"altContactNo2":"9781943310",
"verified": false,
"supportLevel": [
"tier4"
],
"roles": [
"Super Admin"
],
"accessLevel": "global\_access"
"customField": {
"Nickname": "Harsh",
"City": "Ahmedabad"
}
}'

Response

{
"id": 18,
"email": "harsh.bhatia1@motadata.com",
"roles": [
"Super Admin"
],
"locationName": "Asia",
"contactNo": "8905063002",
"altContactNo1": "7816093148",
"altContactNo2": "9781943310",
"departmentName": "HR",
"supportLevel": [
"tier4"
],
"userLogOnName": "Logon101",
"verified": false,
"name": "Harsh Bhatia"
}

Patch Update Technician

http://{{server-url}}/api/v1/technician/{id}

Request

curl --location --request PATCH 'http://172.16.8.220/api/v1/technician/18' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJoYXJzaC5iaGF0aWFAbW90YWRhdGEuY29tIiwic2NvcGUiOlsib3RoZXItYXBpLXNjb3BlIl0sImxvZ2luX3NvdXJjZSI6Im5vcm1hbF9sb2dpbiIsImV4cCI6MTYwMzI1NTI5MiwianRpIjoiOTNlNDQ1MGMtNjBhZC00NjE0LTg5OTItOTU1OWIxZWUwYTM1IiwiY2xpZW50X2lkIjoiSEItY2xpZW50IiwidGVuYW50SWRlbnRpZmllciI6ImFwb2xvIn0.QOvpxH8Vde9EZbPjbTTtdMUS9sR7Xk8KMTjZYg3HPm4' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Update"
}'

Response

{
"id": 18,
"email": "john@motadata.com",
"roles": [
"Super Admin"
],
"locationName": "Asia",
"contactNo": "8905063002",
"altContactNo1": "7816093148",
"altContactNo2": "9781943310",
"departmentName": "HR",
"supportLevel": [
"tier4"
],
"userLogOnName": "john",
"verified": false,
"name": "Update"
}

Convert Technician to Requester

http://{{server-url}}/api/v1/technician/converttorequester/{id}

Request

curl --location --request GET 'http://172.16.8.220/api/v1/technician/converttorequester/18' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJoYXJzaC5iaGF0aWFAbW90YWRhdGEuY29tIiwic2NvcGUiOlsib3RoZXItYXBpLXNjb3BlIl0sImxvZ2luX3NvdXJjZSI6Im5vcm1hbF9sb2dpbiIsImV4cCI6MTYwMzI1NTI5MiwianRpIjoiOTNlNDQ1MGMtNjBhZC00NjE0LTg5OTItOTU1OWIxZWUwYTM1IiwiY2xpZW50X2lkIjoiSEItY2xpZW50IiwidGVuYW50SWRlbnRpZmllciI6ImFwb2xvIn0.QOvpxH8Vde9EZbPjbTTtdMUS9sR7Xk8KMTjZYg3HPm4' \
--data-raw ''

Response

{
"id": 18,
"email": "1tech3motadata@yopmail.com",
"locationName": "Asia",
"contactNo": "8905003003",
"altContactNo1": "1905003203",
"altContactNo2": "2905003203",
"departmentName": "HR",
"manager": "harsh.bhatia@motadata.com",
"userLogOnName": "t3",
"vipRequester": false,
"technician": false,
"verified": false,
"name": "Tech 3 T"
}

Post Search a Technician

http://{{server-url}}/api/v1/technician/search

Request

curl --location --request POST 'http://172.16.8.220/api/v1/technician/search' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJoYXJzaC5iaGF0aWFAbW90YWRhdGEuY29tIiwic2NvcGUiOlsib3RoZXItYXBpLXNjb3BlIl0sImxvZ2luX3NvdXJjZSI6Im5vcm1hbF9sb2dpbiIsImV4cCI6MTYwMzI1NTI5MiwianRpIjoiOTNlNDQ1MGMtNjBhZC00NjE0LTg5OTItOTU1OWIxZWUwYTM1IiwiY2xpZW50X2lkIjoiSEItY2xpZW50IiwidGVuYW50SWRlbnRpZmllciI6ImFwb2xvIn0.QOvpxH8Vde9EZbPjbTTtdMUS9sR7Xk8KMTjZYg3HPm4' \
--header 'Content-Type: application/json' \
--data-raw '{
"manager": "harsh.bhatia@motadata.com",
}'

Response

{
"objectList": [
{
"id": 18,
"email": "1tech3motadata@yopmail.com",
"locationName": "Asia",
"contactNo": "8905003003",
"altContactNo1": "1905003203",
"altContactNo2": "2905003203",
"departmentName": "HR",
"manager": "harsh.bhatia@motadata.com",
"userLogOnName": "t3",
"vipRequester": false,
"technician": false,
"verified": false,
"name": "Tech 3 T"
}
],
"totalCount": 1
}

Delete a Technician

http://{{server-url}}/api/v1/technician/{id}

Request

curl --location --request DELETE 'http://172.16.8.220/api/v1/technician/24' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJoYXJzaC5iaGF0aWFAbW90YWRhdGEuY29tIiwic2NvcGUiOlsib3RoZXItYXBpLXNjb3BlIl0sImxvZ2luX3NvdXJjZSI6Im5vcm1hbF9sb2dpbiIsImV4cCI6MTYwMzI3NzY1MiwianRpIjoiODJmZGQzN2UtNWI2Zi00OTlhLWIzZTAtZTRhNDBmZGVlNWNkIiwiY2xpZW50X2lkIjoiSEItY2xpZW50IiwidGVuYW50SWRlbnRpZmllciI6ImFwb2xvIn0.mtAGKGyadGeSu4IRQCZ0rh6O4b-jHFCX-pX51P2cmxY' \
--data-raw ''

Response

{
"userMessage": "Technician has been Archived Successfully.",
"warningMessage": null,
"id": 24
}