ESET Online Help

Search
Select the category
Select the topic

POST Update list of task triggers

Relative path: /v1/device_tasks/{taskUuid}:updateTaskTriggers

Request body

Display Schema instead of an Example or vice-versa

Type

Required

Example

Schema

application/json

No

{
  "triggers": [
    {
      "manual": {
        "createTime": "string",
        "expireTime": "string"
      }
    }
  ]
}
{
  "$ref": "DeviceTasksUpdateTaskTriggersBody",
  "triggers": [
    {
      "$ref": "v1Trigger",
      "description": "Encodes information about when to run task.",
      "manual": {
        "$ref": "v1ManualTrigger",
        "description": "For manually triggered tasks this trigger causes immediate execution in as soon as possible fashion. Info: Examples: - https://tray.io/documentation/connectors/triggers/manual-trigger/ - https://www.coretechnologies.com/blog/windows-services/trigger-start/ - https://www.nocrm.io/help/manual-trigger-101",
        "createTime": {
          "type": "string",
          "description": "When the manual trigger has been created. Task can only be triggered after this time. Read-only.",
          "format": "date-time"
        },
        "expireTime": {
          "type": "string",
          "description": "Task is not triggered after this time. This is useful for task to not be triggered on stale targets (e.g. those turned on after long time of vacation).",
          "format": "date-time"
        }
      }
    }
  ]
}

Parameters in path

Name

Type

Required

Description

taskUuid

string

Yes

Descriptor of the task to update

type: DeviceTask



Responses

Display Schema instead of an Example or vice-versa

Code

Description

Example

Schema

200

Successful response.

{}
{
  "$ref": "v1UpdateTaskTriggersResponse",
  "title": "empty",
  "type": "object"
}

202

Response took too long; request cached. Response can be retrieved later using the response-id header.

null
[]

400

One of the errors: 1. Bad or missing authorization. 2. Validation error. Invalid argument provided.

null
[]

401

Token has expired or is invalid.

null
[]

403

Access denied. Check permissions.

null
[]

404

Requested resource not found.

null
[]

429

Rate limit reached. Try again later.

null
[]

500

Internal server failure. Try again later.

null
[]

502

Internal server failure. Try again later.

null
[]

503

Environment under maintenance. Try again later.

null
[]

504

Action took too long; timeout reached

null
[]