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", "readOnly": true }, "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" } } } ] }

Type

Required

Example

Schema

application/json

{
  "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",
          "readOnly": true
        },
        "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	[]

˄˅