Work Order Alert REST API
Resource URL Summary
Retrieve the details of a specific Work Order Alert
GET
/s
eiapi/v3/WorkOrder/Alerts/${AlertID}
Insert or Update the details of a specific Work Order Alert
PUT /seiapi/v3/WorkOrder/Alerts/${AlertID}
Insert or Update the details of a specific Work Order Alert for a Service Area
PUT /seiapi/v3/WorkOrder/ServiceArea/${ServiceAreaID}/Alerts/${AlertID}
Bulk Insert or Update the details of specific Work Order Alerts
POST /seiapi/v3/WorkOrder/Alerts
Bulk Insert or Update the details of specific Work Order Alerts for a Service Area
POST /seiapi/v3/WorkOrder/ServiceArea/${ServiceAreaID}/Alerts
Delete a specific Work Order Alert
DELETE /seiapi/v3/WorkOrder/Alerts/${AlertID}
API Specific Parameters
Parameter | Description |
---|---|
${AlertID} | Identifies the Work Order Alert Object. |
${ServiceAreaID} | Identifies the Service Area Object. |
API Specifics
Retrieve the details of a specific Work Order Alert
This REST API will return a Work Order Alert with the specified ID. The Work Order Alert with the specified ID must already exist in the system.
URL
GET
/seiapi/v3/WorkOrder/Alerts/${AlertID}
HTTP Request Body
This request does not require a request body.
HTTP Response
On success, an HTTP status code of 200 will be returned, and the response body will contain an Work Order Alert Object . Otherwise, on error, the response body will contain a descriptive reason for the error.
Insert or Update the details of a specific Work Order Alert
This REST API will insert a new Work Order Alert with the specified ID into the system, if an Work Order Alert with the specified ID does not already exist in the system.
If, however, the Work Order Alert with the specified ID does already exist in the system, then this REST API will update (i.e. replace) the already existing Work Order Alert with the specified ID with the details of the Work Order Alert supplied in the HTTP Request Body.
URL
PUT /seiapi/v3/WorkOrder/Alerts/${AlertID}
HTTP Request Body
The HTTP request body must contain a valid Work Order Alert Object.
HTTP Response
On success the API will return a response code of 200.
Insert or Update the details of a specific Work Order Alert for a Service Area
This REST API will insert a new Work Order Alert with the specified ID into the system for a Service Area, if an Work Order Alert with the specified ID does not already exist in the system. The Service Area with the specified ID must already exist in the system.
If, however, the Work Order Alert with the specified ID does already exist in the system, then this REST API will update (i.e. replace) the already existing Work Order Alert with the specified ID with the details of the Work Order Alert supplied in the HTTP Request Body.
URL
PUT /seiapi/v3/WorkOrder/ServiceArea/${ServiceAreaID}/Alerts/${AlertID}
HTTP Request Body
The HTTP request body must contain a valid Work Order Alert Object.
HTTP Response
On success the API will return a response code of 200.
Bulk Insert or Update the details of specific Work Order Alerts
This REST API will insert one or more new Work Order Alerts with the specified ID into the system, if the Work Order Alerts with the specified IDs do not already exist in the system.
If, however, the Work Order Alerts with the specified IDs do already exist in the system, then this REST API will update (i.e. replace) the already existing Work Order Alerts with the specified IDs with the details of the Work Order Alerts supplied in the HTTP Request Body.
URL
POST
/seiapi/v3/WorkOrder/Alerts
HTTP Request Body
The HTTP request body must be a JSON array of one or more Work Order Alert Object definitions.
HTTP Response
On success the API will return a response code of 200.
Bulk Insert or Update the details of specific Work Order Alerts for a Service Area
This REST API will insert one or more new Work Order Alerts with the specified ID into the system for a Service Area, if the Work Order Alerts with the specified IDs do not already exist in the system. The Service Area with the specified ID must already exist in the system.
If, however, the Work Order Alerts with the specified IDs do already exist in the system, then this REST API will update (i.e. replace) the already existing Work Order Alerts with the specified IDs with the details of the Work Order Alerts supplied in the HTTP Request Body.
URL
POST
/seiapi/v3/WorkOrder/ServiceArea/${ServiceAreaID}/Alerts
HTTP Request Body
The HTTP request body must be a JSON array of one or more Work Order Alert Object definitions.
HTTP Response
On success the API will return a response code of 200.
Delete a specific Work Order Alert
This REST API will delete a Work Order Alert with the specified ID from the system. The Work Order Alert with the specified ID must already exist in the system.
URL
DELETE /seiapi/v3/WorkOrder/Alerts/${AlertID}
HTTP Request Body
This request does not require a request body.
HTTP Response
On success an HTTP response code of 200 will be returned. The system will return HTTP response code 410 in case of non-existent work order alert.