Document toolboxDocument toolbox

Alert Template REST API

3.18.2

The Alert Template REST API is used to mange alert/notification templates in the system. Alerts/notifications provide a means to notify the mobile worker to a specific condition related to either the customer, asset, part, etc in various processes in mobile application. Alerts are controlled by a custom set of rules. Alert Templates are used to customize alert/notification layout and behavior. 

On this page:

Related pages:

Resource URL Summary

Retrieve the details of a specific Alert Template

GET /seiapi/v3/AlertTemplates/${TemplateID} 

Retrieve a list of all Alert Templates

GET /seiapi/v3/AlertTemplates

Insert or Update the details of a specific Alert Template

PUT /seiapi/v3/AlertTemplates/${TemplateID}

Bulk Insert or Update the details of specific Alert Templates

PUT /seiapi/v3/AlertTemplates

Delete a specific Alert Template

DELETE /seiapi/v3/AlertTemplates/${TemplateID}

API Specific Parameters

Parameter
Description
${TemplateID}Identifies the Alert Template Object.

HTTP Headers

This API uses the default ServiceMobility HTTP Headers.



API Specifics

Retrieve the details of a specific Alert Template

This REST API will return an Alert Template with the specified ID. The Alert Template with the specified ID must already exist in the system.

URL

GET /seiapi/v3/AlertTemplates/${TemplateID}

HTTP Request Body

This request does not require a request body. 

HTTP Response Body

On success, an HTTP response code of 200 will be returned, and the response body will contain an Alert Template Object.

JSON Format
{
	"Accept": {
		"DisplayNotes": false,
		"RequireResponseNotes": false
	},
	"Decline": {
		"DisplayNotes": false,
		"RequireResponseNotes": false
	},
	"Deleted": false,
	"Message": "",
	"TemplateID": "",
	"RefID": "",
	"URL": ""
}

Otherwise, on error, the API returns the standard response object.

Retrieve a list of all Alert Templates

This REST API will return a list of all Alert Templates that exist in the system.

URL

GET /seiapi/v3/AlertTemplates

HTTP Request Body

This request does not require a request body. 

HTTP Response

On success, an HTTP status of 200 will be returned, and the response body will contain a collection of Alert Template Objects

(warning) It is possible for the returned collection to be empty if the system does not have any Alert Templates. 

HTTP Response Body
{
	"AlertTemplates" : [
		// A collection of zero or more Alert Template Objects.
	]
}

Otherwise, on error, the API returns the standard response object.

Insert or Update the details of a specific Alert Template

This REST API will insert a new Alert Template with the specified ID into the system, if an Alert Template with the specified ID does not already exist in the system.

If, however, the Alert Template with the specified ID does already exist in the system, then this REST API will update (i.e. replace) the already existing Alert Template with the specified ID with the details of the Alert Template supplied in the HTTP Request Body.

URL

PUT /seiapi/v3/AlertTemplates/${TemplateID}

HTTP Request Body

The HTTP request body must contain a valid Alert Template Object.

HTTP Response

The API returns the standard response object on both success and error.

Bulk Insert or Update the details of specific Alert Templates

This REST API will insert new Alert Templates with the specified IDs into the system, if the Alert Templates with the specified IDs do not already exist in the system.

If, however, the Alert Templates with the specified IDs do already exist in the system, then this REST API will update (i.e. replace) the already existing Alert Templates with the specified IDs with the details of the Alert Templates supplied in the HTTP Request Body.

URL

PUT /seiapi/v3/AlertTemplates

HTTP Request Body

The HTTP request body must be a JSON array of one or more Alert Template Object definitions.

[
	{
		// Alert Template Object
	},
	{
		// Alert Template Object
	},
	{
		// etc., as required
	}
]

HTTP Response

The API returns the standard response object on both success and error.

Delete a specific Alert Template

This REST API will delete an Alert Template with the specified ID from the system. The Alert Template with the specified ID must already exist in the system.

URL

DELETE /seiapi/v3/AlertTemplates/${TemplateID}

HTTP Request Body

This request does not require a request body.

HTTP Response

The API returns the standard response object on both success and error.