Skip to main content

Creates an event preset

POST /v1/eventpreset

Summary​

Creates an event preset.

Details​

Request body: JSON object. Supports creating presets

for either a single device or a device group, based on deviceID or deviceGroupID. If

eventParameters is empty, it is stored as \{\}.

Authentication​

No operation-level security requirement is documented here.

Parameters​

None documented here.

Request Body​

Required: Yes

application/json​

  • eventPresetName (string, optional)
  • deviceID (integer (int64), optional)
  • deviceGroupID (integer (int64), optional)
  • agentType (string, optional)
  • eventType (string, optional)
  • eventParameters (string, optional)
  • priority (integer (int64), optional)
  • maxAttempts (integer (int64), optional)
  • expirationEpoch (integer (int64), optional)

Example

{
  "eventPresetName": "Example value",
  "deviceID": 201,
  "deviceGroupID": 1,
  "agentType": "Device",
  "eventType": "Run",
  "eventParameters": "{\"presetName\":\"Run Event Preset\"}",
  "priority": 1,
  "maxAttempts": 3,
  "expirationEpoch": 1711800000
}

Responses​

200​

Success

application/json​

  • key (integer (int64), optional)
  • eventPresetName (string, optional)
  • deviceID (integer (int64), optional)
  • deviceGroupID (integer (int64), optional)
  • agentTypeID (integer (int64), optional)
  • agentID (integer (int64), optional)
  • eventTypeID (integer (int64), optional)
  • eventStatus (integer (int64), optional)
  • eventParameters (string, optional)
  • processID (integer (int64), optional)
  • result (string, optional)
  • percentComplete (number (double), optional)
  • priority (integer (int64), optional)
  • expirationEpoch (integer (int64), optional)
  • attemptNumber (integer (int64), optional)
  • maxAttempts (integer (int64), optional)
  • tagString (string, optional)
  • tagNumber (integer (int64), optional)
  • creationDate (string (date-time), optional)

Example

{
  "key": 1,
  "eventPresetName": "Example value",
  "deviceID": 201,
  "deviceGroupID": 1,
  "agentTypeID": 1,
  "agentID": 1,
  "eventTypeID": 1,
  "eventStatus": 1,
  "eventParameters": "{\"presetName\":\"Run Event Preset\"}",
  "processID": 4321,
  "result": "Example value",
  "percentComplete": 42.5,
  "priority": 1,
  "expirationEpoch": 1711800000,
  "attemptNumber": 1,
  "maxAttempts": 3,
  "tagString": "Example value",
  "tagNumber": 1,
  "creationDate": "2026-03-30T12:00:00.0000000Z"
}