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.