Request

To update one or more specific attributes of an Event please make a PATCH request to the following URL:

HTTP Method	URL
PATCH	`https://industrial.api.ubidots.com/api/v2.0/events/<event_key>/`

Path Parameters

Parameter	Type	Description
event_key	String	The ID or label of the Event, label should use the prefix `~`

Query Parameters

Parameter	Type	Use	Description
token	String	Authentication	Authentication Token can optionally be sent as a query parameter.

Body Parameters

Parameter	Type	Required?	Description
label	String	No	The API label of Event
name	String	No	Name of the Event
description	String	No	Description of Event
tags	String Array	No	Tags of Event
organization	<organization_key>	No	Key of Organization (ID or label)
triggers	Array of Object Array	No	Triggers of Event
actions	Object Array	No	Actions of Event
isActive	Boolean	No	Is True when Event is active
activeDates	Object	No	Active Dates of Event
globalEvent	Boolean	No	True if Event is a global Event
isStatusWidgetEvent	Boolean	No	True if Event is a Status Widget Event
statusWidgetContext	Object	No	Status Widget Context of Event

Header

Parameter	Required?	Description
X-Auth-Token	Yes	Authentication Token of account

$ curl -X PATCH 'https://industrial.api.ubidots.com/api/v2.0/events/<event_key>' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -d '{
    "label": "if-var0-then-telegram",
    "name": "If var0 then Telegram",
    "description": "",
    "tags": [],
    "organization": null,
    "isActive": true,
    "triggers": [
        [
            {
                "type": "last_value",
                "condition": {
                    "value": "60",
                    "operator": ">",
                    "delay": 0
                },
                "entity": {
                    "type": "variable",
                    "value": [
                        {
                            "id": "567890ff1d8472686e9abb4f"
                        }
                    ],
                    "operator": "or"
                }
            }
        ]
    ],
    "actions": [
        {
            "data": {
                "message": "Hey there, {{variable.name}} was {{last_value}} at {{trigger_timestamp|timestampformat('America/Bogota')}}.\n{{from_email}}",
                "numbers": [
                    {
                        "number": "+57  (300) 808 - 3219",
                        "country": {
                            "id": "CO",
                            "label": "Colombia",
                            "value": "+57"
                        }
                    }
                ]
            },
            "name": "Send Telegram",
            "type": "telegram",
            "isGeneric": true,
            "exclusiveFor": [],
            "repeatAction": false,
            "idGroupAction": "6kfdkaaaa",
            "back_to_normal": false,
            "maxRepetitions": 10,
            "repeatInterval": {
                "unit": "T",
                "value": 60
            }
        }
    ],
    "activeDates": {
        "dates": [
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ]
        ],
        "timezone": "America/Bogota"
    },
    "isGlobalEvent": false,
    "isStatusWidgetEvent": false,
    "statusWidgetContext": {}
}'

{
    "url": "https://industrial.api.ubidots.com/api/v2.0/events/123454201d84727dc57df531",
    "id": "123454201d84727dc57df531",
    "label": "if-var0-then-telegram",
    "name": "If var0 then Telegram",
    "description": "",
    "tags": [],
    "organization": null,
    "isActive": true,
    "lastTriggered": 1590043969239,
    "createdAt": "2020-04-21T06:35:12.368604Z",
    "triggers": [
        [
            {
                "type": "last_value",
                "condition": {
                    "value": "60",
                    "operator": ">",
                    "delay": 0
                },
                "entity": {
                    "type": "variable",
                    "value": [
                        {
                            "id": "567890ff1d8472686e9abb4f"
                        }
                    ],
                    "operator": "or"
                }
            }
        ]
    ],
    "actions": [
        {
            "data": {
                "message": "Hey there, {{variable.name}} was {{last_value}} at {{trigger_timestamp|timestampformat('America/Bogota')}}.\n{{from_email}}",
                "numbers": [
                    {
                        "number": "+57  (300) 808 - 3219",
                        "country": {
                            "id": "CO",
                            "label": "Colombia",
                            "value": "+57"
                        }
                    }
                ]
            },
            "name": "Send Telegram",
            "type": "telegram",
            "isGeneric": true,
            "exclusiveFor": [],
            "repeatAction": false,
            "idGroupAction": "6kfdkaaaa",
            "back_to_normal": false,
            "maxRepetitions": 10,
            "repeatInterval": {
                "unit": "T",
                "value": 60
            }
        }
    ],
    "activeDates": {
        "dates": [
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ],
            [
                [
                    "00:00",
                    "23:59"
                ]
            ]
        ],
        "timezone": "America/Bogota"
    },
    "isGlobalEvent": false,
    "isStatusWidgetEvent": false,
    "statusWidgetContext": {}
}

{
    "code": 400001,
    "message": "Validation Error.",
    "detail": {
        ....
    }
}

{
    "code": 401001,
    "message": "Authentication credentials were not provided.",
    "detail": "Authentication credentials were not provided."
}

Response

Returns an Event object of the updated Event.