Use this resource to request details of the schedules in the organization. You can also use this resource to create, update, or delete schedules.
You can use the following request methods:
- To get schedule details, use a GET request.
- To create a schedule, use a POST request.
- To update a schedule, use a PATCH request.
- To delete a schedule, use a DELETE request.
GET request
To get the details of all schedules in the organization, use the following URI:
/public/core/v3/schedule
To get the details of a schedule using the schedule ID, use the following URI:
/public/core/v3/schedule/<id>
You can use a query parameter to get the details for specific schedules. For example, to get the details of all disabled schedules created by the user jdoe, you might use the following URI:
/public/core/v3/schedule/q=status=='Disabled' and createdBy=='jdoe'
You can use the following query parameters in the URI:
Parameter | Type | Description |
---|---|---|
status | Boolean | Status of the schedule.
|
id | String | Schedule ID. |
name | String | Schedule name. |
updateTime | Date | Last time the schedule was updated, in UTC format.
|
updatedBy | String | User who updated the schedule. |
createdBy | String | User who created the schedule. |
interval | String |
You can use the following operators:
|
GET response
If successful, returns the schedules object for the requested schedule. If you request the details for all schedules, the schedules object contains details for each schedule in the organization.
Returns the error object if errors occur.
The schedules object includes the following attributes:
Field | Type | Description |
---|---|---|
id | String | Schedule ID. |
scheduleFederatedId | String | Schedule ID that includes the location of the schedule. |
name | String | Schedule name. |
status | String | Status of the schedule. Returns one of the following values:
|
description | String | Description of the schedule. |
createTime | Date/time | Time the schedule was created. |
updateTime | Date/time | Last time the schedule was updated. |
createdBy | String | User who created the schedule. |
updatedBy | String | User who last updated the schedule. |
startTime | Date/time | Date and time when the schedule starts running, in UTC format. |
endTime | Date/time | Date and time when the schedule stops running. |
interval | String | Interval or repeat frequency at which the schedule runs. Returns one of the following codes:
|
frequency | Int | Frequency that the schedule runs. Returns a numeric value that represents one of the following:
Minutely and Hourly intervals only. |
rangeStartTime | Date/time | The start of the time range within a day that tasks run. Minutely and Hourly intervals only. |
rangeEndTime | Date/time | The end of the time range within a day that tasks run. Minutely and Hourly intervals only. |
sun | Boolean | Tasks run on Sunday. Returns one of the following codes:
Minutely, Hourly, and Weekly intervals only. |
mon | Boolean |
Minutely, Hourly, and Weekly intervals only. |
tue | Boolean | Tasks run on Tuesday. Returns one of the following codes:
Minutely, Hourly, and Weekly intervals only. |
wed | Boolean | Tasks run on Wednesday. Returns one of the following codes:
Minutely, Hourly, and Weekly intervals only. |
thu | Boolean | Tasks run on Thursday. Returns one of the following codes:
Minutely, Hourly, and Weekly intervals only. |
fri | Boolean | Tasks run on Friday. Returns one of the following codes:
Minutely, Hourly, and Weekly intervals only. |
sat | Boolean | Tasks run on Saturday. Returns one of the following codes:
Minutely, Hourly, and Weekly intervals only. |
weekDay | Boolean | Tasks run on weekdays only. Returns one of the following codes:
Daily interval only. |
dayOfMonth | Boolean | Date of the month that tasks run. Returns a date between 1-28. |
weekOfMonth | Int | Week of the month that tasks run. Returns one of the following codes:
Monthly interval only. |
dayOfWeek | String | Day of the week that tasks run. Returns one of the following codes:
Monthly interval only. |
GET example
To request information about a schedule using the schedule ID, you might use the following request:
GET <baseApiUrl>/public/core/v3/schedule/0An1v84VPL3k6kypOlxq06D0000000000003
Accept: application/json
INFA-SESSION-ID: <session ID>
A successful response might look like the following example:
{
"id": "0An1v84VPL3k6kypOlxq06D0000000000003",
"scheduleFederatedId" : "24bDtKg6d9SbaNlqDolHSR",
"name": "MI_FILE_LISTENER_10107",
"status":"enabled",
"createTime": "2018-12-03T17:34:45.000Z",
"updateTime": "2019-05-09T12:13:34.000Z",
"createdBy": "clouddemo",
"updatedBy": "vnath",
"startTime": "2020-06-09T00:15:55.000Z",
"interval": "Minutely",
"frequency": 5,
"rangeStartTime" : "",
"rangeEndTime" : "",
"mon": true,
"tue": true,
"wed": true,
"thu": true,
"fri": true,
"sat": true,
"sun": true,
"weekDay": false,
"dayOfMonth": 0,
"weekOfMonth": null,
"dayOfWeek": null
}
POST request
To create a schedule, use the following URI:
/public/core/v3/schedule
You can use the following fields in a schedules object:
Field | Type | Required | Description |
---|---|---|---|
name | String | Yes | Schedule name. |
description | String | Description of the schedule. | |
status | String | Status of the schedule. Use one of the following values:
Default is enabled. | |
startTime | Date/time | Yes | Date and time when the schedule starts running, in UTC format. |
endTime | Date/time | Date and time when the schedule stops running. If you do not use this parameter, the schedule runs indefinitely. | |
interval | String | Yes | Interval or repeat frequency at which the schedule runs. Use one of the following options: None. Tasks run at the schedule start time. The schedule does not repeat. Minutely. Tasks run on an interval based on the specified number of minutes, days, and time range. You can use the following parameters:
Hourly. Tasks run on an hourly interval based on the start time of the schedule. You can use the following parameters:
Daily. Tasks run daily at the start time configured for the schedule. You can use the following parameters:
Weekly. Tasks run on a weekly interval based on the start time of the schedule. You can use the following parameters:
To indicate when tasks should run, use dayOfWeek with weekOfMonth, such as the First Monday. Or use dayOfMonth, such as 1. Tip: To run tasks on the last day of the month, use the Last weekOfMonth parameter with the Day dayOfWeek parameter. Default is no interval. |
frequency | Int | Yes | Repeat frequency for tasks. Use one of the following values:
Use with Minutely and Hourly intervals only. |
rangeStartTime | Date/time | The start of the time range within a day that you want tasks to run. Enter a date and time using standard date/time format. Only the time portion is used. | |
rangeEndTime | Date/time | The end of the time range within a day that you want tasks to run. Enter a date and time using standard date/time format. Only the time portion is used. | |
sun | Boolean | Runs tasks on Sunday at the configured time. Use with Minutely, Hourly, and Weekly intervals only. | |
mon | Boolean | Runs tasks on Monday at the configured time. | |
tue | Boolean | Runs tasks on Tuesday at the configured time. | |
wed | Boolean | Runs tasks on Wednesday at the configured time. | |
thur | Boolean | Runs tasks on Thursday at the configured time. | |
fri | Boolean | Runs tasks on Friday at the configured time. | |
sat | Boolean | Runs tasks on Saturday at the configured time. | |
weekDay | Boolean |
Use with the Daily interval only. | |
dayOfMonth | Int | Date of the month that tasks should run. Use a date between 1-28. Tip: To run tasks on the last day of the month, use the Last weekOfMonth parameter with the Day dayOfWeek parameter. | |
weekOfMonth | String | Week of the month that tasks should run. Use with dayOfWeek to specify the day and week of the month that tasks should run. For example, the First Day or the Last Wednesday of the month.
Use with the Monthly interval only. | |
dayOfWeek | String | Day of the week that tasks should run. Use with weekOfMonth to specify the day and week of the month that tasks should run. For example, the First Day or the Last Wednesday of the month.
Use with the Monthly interval only. |
POST response
Returns the schedules response object for the schedule that you created or updated.
Returns an error object if errors occur.
A successful response might look like the following example:
{
"id": "8oKIw0ib9qMg1lGIWNPzkdD000000000000H",
"createTime": "2019-09-30T22:48:28.000Z",
"updateTime": "2019-09-30T22:48:28.000Z",
"createdBy": "demo_schedule",
"updatedBy": "demo_schedule",
"name": "my_schedule_1",
"rangeStartTime": null,
"rangeEndTime": null,
"status": "enabled",
"frequency": 5,
"description": null,
"mon": true,
"tue": false,
"wed": true,
"thu": false,
"fri": false,
"sat": false,
"sun": false,
"weekDay": false,
"dayOfMonth": 0,
"weekOfMonth": null,
"dayOfWeek": null,
"scheduleFederatedId": "1BrVocfYMAzeQHwXaaMWe7",
"startTime": "2020-12-25T12:00:00.000Z",
"endTime": null,
"interval": "Minutely"
}
PATCH request
To update a schedule, use the following URI:
/public/core/v3/schedule/<id>
You can use this request to update, enable, or disable a schedule. Include the following fields in the request body:
Field | Type | Required | Description |
---|---|---|---|
name | String | Schedule name. | |
id | String | Yes | Schedule ID. |
scheduleFederatedId | String | Yes | Federated schedule ID. |
description | String | Description of the schedule. | |
status | String | Status of the schedule. Use one of the following values:
Default is enabled. | |
startTime | Date/time | Date and time when the schedule starts running, in UTC format. | |
endTime | Date/time | Date and time when the schedule stops running. If you do not use this parameter, the schedule runs indefinitely. | |
interval | String | Interval or repeat frequency at which the schedule runs. Use one of the following options: None. Tasks run at the schedule start time. The schedule does not repeat. Minutely. Tasks run on an interval based on the specified number of minutes, days, and time range. You can use the following parameters:
Hourly. Tasks run on an hourly interval based on the start time of the schedule. You can use the following parameters:
Daily. Tasks run daily at the start time configured for the schedule. You can use the following parameters:
Weekly. Tasks run on a weekly interval based on the start time of the schedule. You can use the following parameters:
To indicate when tasks should run, use dayOfWeek with weekOfMonth, such as the First Monday. Or use dayOfMonth, such as 1. Tip: To run tasks on the last day of the month, use the Last weekOfMonth parameter with the Day dayOfWeek parameter. Default is no interval. | |
frequency | Int | Repeat frequency for tasks. Use one of the following values:
Use with Minutely and Hourly intervals only. | |
rangeStartTime | Date/time | The start of the time range within a day that you want tasks to run. Enter a date and time using standard date/time format. Only the time portion is used. | |
rangeEndTime | Date/time | The end of the time range within a day that you want tasks to run. Enter a date and time using standard date/time format. Only the time portion is used. | |
sun | Boolean | Runs tasks on Sunday at the configured time. Use with Minutely, Hourly, and Weekly intervals only. | |
mon | Boolean | Runs tasks on Monday at the configured time. | |
tue | Boolean | Runs tasks on Tuesday at the configured time. | |
wed | Boolean | Runs tasks on Wednesday at the configured time. | |
thur | Boolean | Runs tasks on Thursday at the configured time. | |
fri | Boolean | Runs tasks on Friday at the configured time. | |
sat | Boolean | Runs tasks on Saturday at the configured time. | |
weekDay | Boolean | Runs tasks on weekdays. Use one of the following options:
Use with the Daily interval only. | |
dayOfMonth | Int | Date of the month that tasks should run. Use a date between 1-28. Tip: To run tasks on the last day of the month, use the Last weekOfMonth parameter with the Day dayOfWeek parameter. | |
weekOfMonth | String | Week of the month that tasks should run. Use with dayOfWeek to specify the day and week of the month that tasks should run. For example, the First Day or the Last Wednesday of the month.
Use with the Monthly interval only. | |
dayOfWeek | String | Day of the week that tasks should run. Use with weekOfMonth to specify the day and week of the month that tasks should run. For example, the First Day or the Last Wednesday of the month.
Use with the Monthly interval only. |
PATCH example
To update a schedule, your request might look something like the following example:
PATCH <baseApiUrl>/public/core/v3/schedule/0An1v84VPL3k6kypOlxq06D0000000000003
Accept: application/json
INFA-SESSION-ID: <session ID>
{
"schedules": [
{
"id": "{{scheduleId}}",
"scheduleFederatedId" : "{{scheduleFrsId}}",
"name": "V3_Test_CreateSchedule_{{$timestamp}}",
"status":"disabled",
"description": "Update version 2",
"sat" : true
}
]
}
A successful response might look like the following example:
{
"id": "8oKIw0ib9qMg1lGIWNPzkdD0000000000006",
"createTime": "2019-09-24T15:34:36.000Z",
"updateTime": "2019-10-01T15:47:59.442Z",
"createdBy": "demo_schedule",
"updatedBy": "demo_schedule",
"name": "V3_Test_CreateSchedule_1569944878",
"rangeStartTime": null,
"rangeEndTime": null,
"status": "disabled",
"frequency": 1,
"description": "Update version 2",
"mon": false,
"tue": false,
"wed": true,
"thu": false,
"fri": false,
"sat": true,
"sun": false,
"weekDay": false,
"dayOfMonth": 0,
"weekOfMonth": null,
"dayOfWeek": null,
"scheduleFederatedId": "1KiAwzRVIOTlAtCjPtzV4H",
"startTime": "2020-12-25T12:00:00.000Z",
"endTime": null,
"interval": "Hourly"
}
DELETE request
To delete a schedule, use the following URI:
/public/core/v3/schedule/<id>
DELETE response
Returns the 204 response code if the request is successful.
Returns an error object if errors occur.