Select the tab
ESET Connect – Table of Contents

POST Update task triggers

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

Update the list of task triggers.

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 the task.",
      "manual": {
        "$ref": "v1ManualTrigger",
        "description": "For manually triggered tasks, this trigger causes immediate execution in as soon as possible fashion. Info: Examples: - Triggers: Manual Trigger - Windows Services: Trigger Start - Manual Trigger",
        "createTime": {
          "type": "string",
          "description": "When the manual trigger has been created. The task can only be triggered after this time. Read-only.",
          "format": "date-time",
          "readOnly": true
        },
        "expireTime": {
          "type": "string",
          "description": "Task is not triggered after this time. This is useful for the task to not be triggered on stale targets (for example, 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
 
[]