Service Request API

Product: NEXTMEGABYTE (Greenitco ITAM) · Module: API Documentation · Audience: Developer, Administrator

This page lists the NEXTMEGABYTE REST API endpoints for service requests. All URLs are relative to your portal, for example https://your-domain.com/api/.... Authenticate first with the Login API and send the standard headers described in the API Overview. Example values are shortened and anonymized.

List my service requests

POST /api/tickets/myRequestList

Returns the service requests created by the signed-in user.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Example response (shortened)

{ "total": 30, "filtered": 30, "current_index": 0, "is_prev_index": 0, "is_next_index": 1, "pab": [ { "id": 1, "name": "Group Approval" }, { "id": 2, "name": "Level By Level" }, { "id": 3, "name": "Minimum Approval" }, { "id": 4, "name": "HR Team" }, { "id": 5, "name": "Manager Approval1" }, { "id": 6, "name": "Test tesm" }, { "id": 7, "name": "Greenitco" }, { "id": 8, "name": "testr" }, { "id": 9 …

Get service request details

GET /api/tickets/getServiceRequestInfo/<request-id>

Returns the details, approvers and approval status of a service request.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Example response (shortened)

{ "msg": "successfully get the request", "status": "success", "vd": { "statuses": [ { "id": 5, "name": "Cancelled" }, { "id": 6, "name": "On Hold" } ], "form_visible": { "tr_update_form": true } }, "request": { "id": 8546, "procure_tag": "SR8546", "status_id": 2, "ticket_id": 8546, "subject": "TestCategoryIn - Prob cate test demo test", "content": "test", "department_id": 124, "problem_category_id …

List service requests

POST /api/tickets/requestAjaxList

Returns a paged list of all service requests the user can access.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Get service request filter options

GET /api/tickets/requestsFilterOptions

Returns the values available for service request filters.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Top-level response fields: status, msg, departments, filter_by_dates_opts, authority_board, statuses

Example response (values shortened and anonymized)

{
  "status": "success",
  "msg": "",
  "departments": [
    {
      "id": 1,
      "name": "Developing"
    },
    "..."
  ],
  "filter_by_dates_opts": [
    {
      "id": 1,
      "text": "<string>"
    },
    "..."
  ],
  "authority_board": [
    {
      "id": 1,
      "name": "Group Approval"
    },
    "..."
  ],
  "statuses": [
    {
      "id": 1,
      "name": "Created"
    },
    "..."
  ]
}

Open a service request form

GET /api/tickets/serviceRequestForm/{id}

Returns the dynamic form attached to a problem category for a new service request.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Example response (shortened)

{ "status": "success", "msg": "", "tmp_id": "jMZOvloE1727449379", "data": { "id": 13, "form_name": "USB-PCB", "descriptions": "USB-Connect PCB’s/Boards/other hardware-Questionnaire", "fields": "[{\\type\\:\\header\\,\\subtype\\:\\h1\\,\\label\\:\\USB Enablement Request -Connect PCB’s/Boards/other hardware-Questionnaire\\,\\access\\:false},{\\type\\:\\text\\,\\required\\:true,\\label\\:\\Please men …

Submit a service request form

POST /api/dynamic_form/update_form

Saves the answers of a dynamic form for a service request.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Request Body Parameters

Parameter	Type	Required	Description
form_id	int	Yes	Form ID
request_id	String	Yes	Ticket ID
tmp_id	String	Yes	Temporary ID
field_values	json encoded	Yes	Map form fields

Example response (shortened)

{status: success, msg: Requested Form Added Successfully!, requested_form_id: 1002}

Update a service request form

POST /api/dynamic_form/form/update

Updates previously submitted dynamic form answers.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Request Body Parameters

Parameter	Type	Required	Description
form_id	int	Yes	Form ID
request_id	String	Yes	Ticket ID
tmp_id	String	Yes	Temporary ID
field_values	json encoded	Yes	Map form fields

Example response (shortened)

{status: success, msg: Requested Form Updated Successfully!, requested_form_id: 1002, requested_id: 6188}

Approve or reject a service request

POST /api/tickets/requestApprove/{id}

Records the signed-in approver's decision and comment on a service request.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Request Body Parameters

Parameter	Type	Required	Description
approve_status	String	Yes	Approve Status
approve_request_id	String	Yes	Aprove Request ID
comments	String	Yes	Comments

Example response (values shortened and anonymized)

{
  "msg": "Your response has been sent successfully.",
  "status": "success"
}

Revoke an approval decision

POST /api/tickets/revokeDecision/{id}

Withdraws the signed-in approver's earlier decision on a service request.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Request Body Parameters

Parameter	Type	Required	Description
approve_request_id	String	Yes	Aprove Request ID

Example response (shortened)

{msg: Your early decision has been revoked successfully, status: success}

Update service request status

POST /api/tickets/updateRequestInfo/{id}

Updates the status and details of a service request.

Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.

Request Body Parameters

Parameter	Type	Required	Description
status_id	String	Yes	Status ID
id	String	Yes	Ticket ID
tmp_id	String	Yes	Temporary ID
comment	String	Yes	Comments
is_note	bool	Yes	Make Note
follow_cc	bool	Yes	Do CC E-mail
cc_emails	String	Yes	CC E-mail
add_back_trail	bool	Yes	Add Back Trail

Example response (values shortened and anonymized)

{
  "msg": "Request Status has been changed successfully",
  "status": "success"
}