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 |
[] |