Schedules
Get schedules
get/datainsights/v1.1/schedules
Request
- The document declares no server URL.
- Auth
- HTTP bearer
- or API key in header X-API-KEY
Query parameters
offsetinteger
The difference between start of the data and the start of the response data
limitinteger
Example:5
The maximum number of results in the response
idinteger
Filter by Schedule ID
subjectstring
Subject of the email
frequencystring
Schedule frequency in cron format.
Needs to match the following pattern:
(0)\ # minutes ~ 0
(\*|([0-9]|1[0-9]|2[0-3])|\*)\ # hours ~ * OR 0-23
(\*|([1-9]|[1-2][0-9]?|3[0-1]))?(,(\*|([1-9]|[1-2][0-9]?|3[0-1]))){0,30}\ # day of month ~ * OR 1-31
(\*|([1-9]|1[0-2]?))?(,(\*|([1-9]|1[0-2]?))){0,12}\ # month ~ * OR 1-12
(\*|[0-6])(,(\*|[0-6])){0,7} # day of week ~ * OR 0-6
$ # matches the end of the string
- 0 10 * * 0,1,2,4,5 - At 10:00 on Sunday, Monday, Tuesday, Thursday, and Friday
- 0 10 * * 2 - At 10:00 on Tuesday
- 0 23 * 12 * - At 23:00 in December
- 0 23 1,31 1,2,5,6,7,10,11 1,3 - At 08:00 on day-of-month 1 and 31 and on Monday and Wednesday in January, February, May, June, July, October, and November
matchstring
Match schedule frequency based on date (2022-01-02T18:00:00Z)
sort'subject,asc' | 'subject,desc' | 'view,asc' | 'view,desc' | 'format,asc' | 'format,desc' | 'created_at,asc' | 'created_at,desc' | 'updated_at,asc' | 'updated_at,desc' | 'id,asc' | 'id,desc'
Sort schedules
Headers
X-PROPERTY-IDinteger
Property id of the client
Response
OK
Example response
{
"limit": 5,
"total": 42,
"schedules": [
{
"id": 1,
"frequency": "0 10 15 * *",
"view": "formatted",
"format": "xlsx",
"created_at": "2022-01-01T12:00:00Z",
"updated_at": "2022-01-02T10:00:00Z",
"upcoming_at": "2022-01-02T18:00:00Z",
"property_id": 1
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.