When a Cycle is initially installed within an Account, it may be in a paused state and must be activated to run.
When a Cycle has been installed and all of its prerequisites have been provided, the Cycle can then be activated using this API call:
Request:
PUT /v1.0/cycles/{Cycle ID}/activate
Authorization Bearer ********************
X-Cyclr-Account: 00000000-0000-0000-0000-000000000000
{
"StartTime": "2018-01-01T00:00:00Z",
"Interval": 360,
"RunOnce": false
}
Parameter | Description |
---|---|
Interval | The frequency, in minutes, that the Cycle should run at – ignored if first step is webhook or RunOnce is true |
StartTime | Optional, the time for the Cycle to start (UTC) |
RunOnce | Optional, set to true for the Cycle to auto paused after the first run |
Valid Intervals:
Interval | Time |
---|---|
1 | 1 Minute |
5 | 5 Minutes |
15 | 15 Minutes |
30 | 30 Minutes |
60 | 1 Hour |
120 | 2 Hours |
180 | 3 Hours |
240 | 4 Hours |
360 | 6 Hours |
480 | 8 Hours |
720 | 12 Hours |
1440 | 1 Day |
10080 | 1 Week |
Response:
200 OK
The Cycle will then run at the specified StartTime
and run every Interval
number of minutes, unless RunOnce
is true
, in which case the Cycle will run one time at the StartTime
.