Skip to main content

Schedules Endpoints

Schedules Endpoints and Parameters

Create a New Schedule

Get Information about All Schedules

Search for a Specific Schedule

Update an Existing Schedule

Delete a Schedule

To learn more about the objects relations and how to use them in the API, go to the Object Relations section.

For more information about schedules, visit the Schedules help page.

Create a New Schedule

To create a new schedule, use the POST {baseURL}/v3/schedules endpoint.

Note

Only Curators can use this API endpoint.

If timeZone is empty or skipped, all Date Time fields will correspond to the UTC-0 timezone. If the timeZone is specified, all the Date Time fields will correspond to the specified timezone. To view the list of valid timezones, go to Timezones.

Parameters

  • contract (body): To create a new schedule, the contract parameter is required. Specify the following parameters:

    • workflowId (string): Enter a workflow ID you want to schedule.

    • iteration (body):

      • iterationType (string): Specify whether the workflow will be scheduled ‘Once’, ‘Hourly’, ‘Daily’, ‘Weekly’, ‘Monthly’, and ‘Custom’. Don’t forget to specify the hourly (hourlyContract), daily (dailyContract), weekly (weeklyContract), monthly (monthlyContract), or custom (customContract) frequency for the respective iteration type. For more information, visit the Schedule a Workflow help page.

      • startTime (string): Required. Enter a specific date and time to run the workflow. The start date must be in the future.

      • endTime (string): Optional. Enter the specific date and time when the workflow run should end.

      • hourlyContract (body): Optional. Use if you specified the iterationType as 'Hourly'.

        • hours (string): Enter the hour.

        • minutes (string): Enter the minutes.

      • dailyContract (body): Optional. Use if you specified the iterationType as 'Daily'.

        • runOnlyWorkWeek (boolean): Optional. If not specified, the default is false.

      • weeklyContract (body): Optional. Use if you specified the iterationType as 'Weekly'.

        • daysOfWeek (string): Specify the day of the week when the workflow should run. For example, 'Sunday'.

      • monthlyContract (body): Optional. Use if you specified the iterationType as 'Monthly'.

        • simpleDayOfMonth (boolean): Enter ‘true’ if you want to specify a specific day of the month when the workflow should run.

        • dayOfMonth (string): Enter the number of the day of the month you want the workflow to run. For example, enter ‘1’ for the first day of the month.

        • occurrence (string): Enter one of the following options if you want the workflow to run for example, the first Sunday of the month. The acceptable values are: '1' (first occurrence), '2' (second occurrence), '3' (third occurrence), '4' (fourth occurrence), and '-1' (the last occurrence of the month).

        • dayOfWeek (integer): Specify the day of the week when the workflow should run. For example, for Sunday enter ‘0’ or ‘Sunday’.

      • customContract (body): Optional. Use if you specified the iterationType as ‘Custom’.

        • daysOfMonth (array): Specify the days of the month when the workflow should run. For example, [1, 15, 28].

        • months (array): Specify the month when the workflow should run. For example, [1, 5, 7, 9, 12].

  • name (string): Optional. Enter a name of the schedule.

  • comment (string): Optional. Enter a comment if needed.

  • priority (string): Optional. Specify the priority for running schedule. Choose from the following options: ‘Low’, ‘Medium’, ‘High’, and ‘Critical’. If not specified, the default value will be ‘Low’.

  • workerTag (string): Optional. Specify the assigned worker. If not specified, the value will be ‘none’.

  • credentialId (string): Optional.

  • timeZone (string): Optional. Specify timezone in which the schedule should be created. For more information about valid timezones, go to Timezones.

    Example: "timeZone": "Etc/GMT+4"

Request Example: JSON

Example of a request to create a schedule with the following occurrence - once, with a start and end time specified:

Example of a request when you want to create a schedule with the following occurrence: Once, with a start and end time specified.

Example of a request to create a schedule with hourly occurrence:

Example of a request for a schedule with hourly occurrence. 

Example of a request to create a schedule with weekly occurrence:

Example of a request for a schedule with weekly occurrence. 

Example of a request to create a schedule with monthly occurrence - 2nd Sunday of every month:

Example of a request for a schedule with monthly occurrence - 2nd Sunday of every month. 

Example of a request to create a schedule with monthly occurrence - every 15th day of the month:

Example of a request for a schedule with monthly occurrence - every 15th day of the month.

Example of a request to create a custom schedule:

Example of a request for a custom schedule in JSON.

Get Information about All Schedules

To get information about all schedules, use the GET {baseURL}/v3/schedules endpoint. Use various parameters to filter the schedules you want to display.

Note

When you filter schedules using runsAfter and runsBefore, you are limited to 45 days apart from each other.

Parameters

  • view (string): Optional. Can be left without a value. You can choose from the following values: ‘Default’ and ‘Full’. If this parameter is set to 'Default’, then a reduced view object will be returned. When not specified, the ‘Default’ value is used.

  • ownerId (string): Optional. Enter the owner ID by which you want to filter the schedule.

  • workflowId (string): Optional. Enter the workflow ID by which you want to filter the schedule.

  • runsAfter (date-time): Optional. Enter the date and time after which the schedule runs. Enter the date and time in ISO8601 format.

  • runsBefore (date-time): Optional. Enter the date and time before which the schedule runs. Enter the date and time in ISO8601 format.

Request Example: cURL

curl --location --request GET 'http://localhost/webapi/v3/schedules' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Search for a Specific Schedule

To search for a specific schedule, use the GET {baseURL}/v3/schedules/{id} endpoint.

Parameters

  • id (string): Required. Enter a schedule ID to retrieve information about this schedule.

Request Example: cURL

curl --location --request GET 'http://localhost/webapi/v3/schedules/61dc1a461b140000d60062c2' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Update an Existing Schedule

To update an existing schedule, use the PUT {baseURL}/v3/schedules/{id} endpoint.

Note

Only Curators can use this API endpoint.

If timeZone is empty or skipped, all Date Time fields will correspond to the UTC-0 timezone. If the timeZone is specified, all the Date Time fields will correspond to the specified timezone. To view the list of valid timezones, go to Timezones.

Parameters

  • id (string): Required. Enter a schedule ID to get this schedule updated.

  • contract (body): Required. To update a schedule, the Contract parameter is required. Specify the following:

  • id (string): Required. Enter a schedule ID to get this user updated.

  • ownerId (string): Required. Enter a user’s Id.

  • iteration (body):

    • iterationType (string): Specify whether the workflow will be scheduled ‘Once’, ‘Hourly’, ‘Daily’, ‘Weekly’, ‘Monthly’, and ‘Custom’. Don’t forget to specify the hourly (hourlyContract), daily (dailyContract), weekly (weeklyContract), monthly (monthlyContract), or custom (customContract) frequency for the respective iteration type. For more information, visit the Schedule a Workflow help page.

    • startTime (string): Required. Enter a specific date and time to run the workflow. The start date must be in the future.

    • endTime (string): Required. Enter the specific date and time when the workflow run should end.

    • hourlyContract (body): Optional. Use if you specified the iterationType as 'Hourly'.

      • hours (string): Enter the hour.

      • minutes (string): Enter the minutes.

    • dailyContract (body): Optional. Use if you specified the iterationType as 'Daily'.

      • runOnlyWorkWeek (boolean): Optional. If not specified, the default is false.

    • weeklyContract (body): Optional. Use if you specified the iterationType as 'Weekly'.

      • daysOfWeek (string): Specify the day of the week when the workflow should run. For example, 'Sunday'.

    • monthlyContract (body): Optional. Use if you specified the iterationType as 'Monthly'.

      • simpleDayOfMonth (boolean): Enter ‘true’ if you want to specify a specific day of the month when the workflow should run.

      • dayOfMonth (string): Enter the number of the day of the month you want the workflow to run. For example, enter ‘1’ for the first day of the month.

      • occurrence (string): Enter one of the following options if you want the workflow to run for example, the first Sunday of the month. The acceptable values are: '1' (first occurrence), '2' (second occurrence), '3' (third occurrence), '4' (fourth occurrence), and '-1' (the last occurrence of the month).

      • dayOfWeek (integer): Specify the day of the week when the workflow should run. For example, for Sunday enter ‘0’ or ‘Sunday’.

    • customContract (body): Optional. Use if you specified the iterationType as ‘Custom’.

      • daysOfMonth (array): Specify the days of the month when the workflow should run. For example, [1, 15, 28].

      • months (array): Specify the month when the workflow should run. For example, [1, 5, 7, 9, 12].

  • name (string): Required. Enter a name of the schedule.

  • comment (string): Required. Enter a comment if needed.

  • priority (string): Optional. Specify the priority for running schedule. Choose from the following options: ‘Low’, ‘Medium’, ‘High’, and ‘Critical’. If not specified, the default value is ‘Low’.

  • workerTag (string): Required. Specify the assigned worker. If not specified, the value will be ‘none’.

  • enabled (boolean): Optional. Specify whether the schedule should be enabled or disabled.

  • credentialId (string): Required.

  • timeZone (string): Optional. Specify timezone in which the schedule should be created. For more information about valid timezones, go to Timezones.

    Example: "timeZone": "Etc/GMT+4"

Request Example: JSON

Example of a request to update a schedule – change of the start and end time, name, and comment (body):

Updating a schedule – changing the start and end time, name, and comment.

Delete a Schedule

To delete a specific schedule from the system, use the DELETE {baseURL}/v3/schedules/{id} endpoint.

Parameters

id (string): Required. Enter the schedule ID you want to delete.

Request Example: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/schedules/61dc1a461b140000d60062c2' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Objects Relations

If you are creating a schedule, you can use created objects as follows:

Object created: "id" (for example, "id": "619158e57e607d0011ac3009")

You can use it as:

Postman Request Examples

GET /v3/schedules/

Use GET /v3/schedules/ endpoint.

To know more about Postman requests, visit the How to Use Postman help page.

Timezones

This table lists the valid timezones you can enter while using the following endpoints:

  • POST {baseURL}/v3/schedules 

  • PUT {baseURL}/v3/schedules 

  • GET {baseURL}/v3/schedules/{id} 

  • GET {baseURL}/v3/schedules 

Timezone

Offset from UTC

Etc/GMT+12

-12:00

Etc/GMT+11

-11:00

Pacific/Niue

-11:00

Pacific/Pago_Pago

-11:00

Etc/GMT+10

-10:00

HST

-10:00

Pacific/Honolulu

-10:00

Pacific/Rarotonga

-10:00

Pacific/Tahiti

-10:00

Pacific/Marquesas

-09:30

America/Adak

-09:00

Etc/GMT+9

-09:00

Pacific/Gambier

-09:00

America/Anchorage

-08:00

America/Juneau

-08:00

America/Metlakatla

-08:00

America/Nome

-08:00

America/Sitka

-08:00

America/Yakutat

-08:00

Etc/GMT+8

-08:00

Pacific/Pitcairn

-08:00

America/Creston

-07:00

America/Dawson

-07:00

America/Dawson_Creek

-07:00

America/Fort_Nelson

-07:00

America/Hermosillo

-07:00

America/Los_Angeles

-07:00

America/Phoenix

-07:00

America/Tijuana

-07:00

America/Vancouver

-07:00

America/Whitehorse

-07:00

Etc/GMT+7

-07:00

MST

-07:00

PST8PDT

-07:00

America/Belize

-06:00

America/Boise

-06:00

America/Cambridge_Bay

-06:00

America/Chihuahua

-06:00

America/Costa_Rica

-06:00

America/Denver

-06:00

America/Edmonton

-06:00

America/El_Salvador

-06:00

America/Guatemala

-06:00

America/Inuvik

-06:00

America/Managua

-06:00

America/Mazatlan

-06:00

America/Ojinaga

-06:00

America/Regina

-06:00

America/Swift_Current

-06:00

America/Tegucigalpa

-06:00

America/Yellowknife

-06:00

Etc/GMT+6

-06:00

MST7MDT

-06:00

Pacific/Galapagos

-06:00

America/Atikokan

-05:00

America/Bahia_Banderas

-05:00

America/Bogota

-05:00

America/Cancun

-05:00

America/Chicago

-05:00

America/Eirunepe

-05:00

America/Guayaquil

-05:00

America/Indiana/Knox

-05:00

America/Indiana/Tell_City

-05:00

America/Jamaica

-05:00

America/Lima

-05:00

America/Matamoros

-05:00

America/Menominee

-05:00

America/Merida

-05:00

America/Mexico_City

-05:00

America/Monterrey

-05:00

America/North_Dakota/Beulah

-05:00

America/North_Dakota/Center

-05:00

America/North_Dakota/New_Salem

-05:00

America/Panama

-05:00

America/Rainy_River

-05:00

America/Rankin_Inlet

-05:00

America/Resolute

-05:00

America/Rio_Branco

-05:00

America/Winnipeg

-05:00

CST6CDT

-05:00

EST

-05:00

Etc/GMT+5

-05:00

Pacific/Easter

-05:00

America/Asuncion

-04:00

America/Barbados

-04:00

America/Blanc-Sablon

-04:00

America/Boa_Vista

-04:00

America/Campo_Grande

-04:00

America/Caracas

-04:00

America/Cuiaba

-04:00

America/Curacao

-04:00

America/Detroit

-04:00

America/Grand_Turk

-04:00

America/Guyana

-04:00

America/Havana

-04:00

America/Indiana/Indianapolis

-04:00

America/Indiana/Marengo

-04:00

America/Indiana/Petersburg

-04:00

America/Indiana/Vevay

-04:00

America/Indiana/Vincennes

-04:00

America/Indiana/Winamac

-04:00

America/Iqaluit

-04:00

America/Kentucky/Louisville

-04:00

America/Kentucky/Monticello

-04:00

America/La_Paz

-04:00

America/Manaus

-04:00

America/Martinique

-04:00

America/Nassau

-04:00

America/New_York

-04:00

America/Nipigon

-04:00

America/Pangnirtung

-04:00

America/Port_of_Spain

-04:00

America/Port-au-Prince

-04:00

America/Porto_Velho

-04:00

America/Puerto_Rico

-04:00

America/Santo_Domingo

-04:00

America/Thunder_Bay

-04:00

America/Toronto

-04:00

EST5EDT

-04:00

Etc/GMT+4

-04:00

America/Araguaina

-03:00

America/Argentina/Buenos_Aires

-03:00

America/Argentina/Catamarca

-03:00

America/Argentina/Cordoba

-03:00

America/Argentina/Jujuy

-03:00

America/Argentina/La_Rioja

-03:00

America/Argentina/Mendoza

-03:00

America/Argentina/Rio_Gallegos

-03:00

America/Argentina/Salta

-03:00

America/Argentina/San_Juan

-03:00

America/Argentina/San_Luis

-03:00

America/Argentina/Tucuman

-03:00

America/Argentina/Ushuaia

-03:00

America/Bahia

-03:00

America/Belem

-03:00

America/Cayenne

-03:00

America/Fortaleza

-03:00

America/Glace_Bay

-03:00

America/Goose_Bay

-03:00

America/Halifax

-03:00

America/Maceio

-03:00

America/Moncton

-03:00

America/Montevideo

-03:00

America/Paramaribo

-03:00

America/Punta_Arenas

-03:00

America/Recife

-03:00

America/Santarem

-03:00

America/Santiago

-03:00

America/Sao_Paulo

-03:00

America/Thule

-03:00

Antarctica/Palmer

-03:00

Antarctica/Rothera

-03:00

Atlantic/Bermuda

-03:00

Atlantic/Stanley

-03:00

Etc/GMT+3

-03:00

America/St_Johns

-02:30

America/Godthab

-02:00

America/Miquelon

-02:00

America/Noronha

-02:00

Atlantic/South_Georgia

-02:00

Etc/GMT+2

-02:00

Atlantic/Cape_Verde

-01:00

Etc/GMT+1

-01:00

Africa/Abidjan

+00:00

Africa/Accra

+00:00

Africa/Bissau

+00:00

Africa/Monrovia

+00:00

Africa/Sao_Tome

+00:00

America/Danmarkshavn

+00:00

America/Scoresbysund

+00:00

Atlantic/Azores

+00:00

Atlantic/Reykjavik

+00:00

Etc/GMT

+00:00

Etc/UTC

+00:00

Africa/Algiers

+01:00

Africa/Casablanca

+01:00

Africa/El_Aaiun

+01:00

Africa/Lagos

+01:00

Africa/Ndjamena

+01:00

Africa/Tunis

+01:00

Atlantic/Canary

+01:00

Atlantic/Faroe

+01:00

Atlantic/Madeira

+01:00

Etc/GMT-1

+01:00

Europe/Dublin

+01:00

Europe/Lisbon

+01:00

Europe/London

+01:00

WET

+01:00

Africa/Cairo

+02:00

Africa/Ceuta

+02:00

Africa/Johannesburg

+02:00

Africa/Khartoum

+02:00

Africa/Maputo

+02:00

Africa/Tripoli

+02:00

Africa/Windhoek

+02:00

Antarctica/Troll

+02:00

CET

+02:00

Etc/GMT-2

+02:00

Europe/Amsterdam

+02:00

Europe/Andorra

+02:00

Europe/Belgrade

+02:00

Europe/Berlin

+02:00

Europe/Brussels

+02:00

Europe/Budapest

+02:00

Europe/Copenhagen

+02:00

Europe/Gibraltar

+02:00

Europe/Kaliningrad

+02:00

Europe/Luxembourg

+02:00

Europe/Madrid

+02:00

Europe/Malta

+02:00

Europe/Monaco

+02:00

Europe/Oslo

+02:00

Europe/Paris

+02:00

Europe/Prague

+02:00

Europe/Rome

+02:00

Europe/Stockholm

+02:00

Europe/Tirane

+02:00

Europe/Vienna

+02:00

Europe/Warsaw

+02:00

Europe/Zurich

+02:00

MET

+02:00

Africa/Juba

+03:00

Africa/Nairobi

+03:00

Antarctica/Syowa

+03:00

Asia/Amman

+03:00

Asia/Baghdad

+03:00

Asia/Beirut

+03:00

Asia/Damascus

+03:00

Asia/Famagusta

+03:00

Asia/Gaza

+03:00

Asia/Hebron

+03:00

Asia/Jerusalem

+03:00

Asia/Nicosia

+03:00

Asia/Qatar

+03:00

Asia/Riyadh

+03:00

EET

+03:00

Etc/GMT-3

+03:00

Europe/Athens

+03:00

Europe/Bucharest

+03:00

Europe/Chisinau

+03:00

Europe/Helsinki

+03:00

Europe/Istanbul

+03:00

Europe/Kiev

+03:00

Europe/Kirov

+03:00

Europe/Minsk

+03:00

Europe/Moscow

+03:00

Europe/Riga

+03:00

Europe/Simferopol

+03:00

Europe/Sofia

+03:00

Europe/Tallinn

+03:00

Europe/Uzhgorod

+03:00

Europe/Vilnius

+03:00

Europe/Zaporozhye

+03:00

Asia/Baku

+04:00

Asia/Dubai

+04:00

Asia/Tbilisi

+04:00

Asia/Yerevan

+04:00

Etc/GMT-4

+04:00

Europe/Astrakhan

+04:00

Europe/Samara

+04:00

Europe/Saratov

+04:00

Europe/Ulyanovsk

+04:00

Europe/Volgograd

+04:00

Indian/Mahe

+04:00

Indian/Mauritius

+04:00

Indian/Reunion

+04:00

Asia/Kabul

+04:30

Asia/Tehran

+04:30

Antarctica/Mawson

+05:00

Asia/Aqtau

+05:00

Asia/Aqtobe

+05:00

Asia/Ashgabat

+05:00

Asia/Atyrau

+05:00

Asia/Dushanbe

+05:00

Asia/Karachi

+05:00

Asia/Oral

+05:00

Asia/Qyzylorda

+05:00

Asia/Samarkand

+05:00

Asia/Tashkent

+05:00

Asia/Yekaterinburg

+05:00

Etc/GMT-5

+05:00

Indian/Kerguelen

+05:00

Indian/Maldives

+05:00

Asia/Colombo

+05:30

Asia/Kolkata

+05:30

Asia/Kathmandu

+05:45

Antarctica/Vostok

+06:00

Asia/Almaty

+06:00

Asia/Bishkek

+06:00

Asia/Dhaka

+06:00

Asia/Omsk

+06:00

Asia/Qostanay

+06:00

Asia/Thimphu

+06:00

Asia/Urumqi

+06:00

Etc/GMT-6

+06:00

Indian/Chagos

+06:00

Asia/Yangon

+06:30

Indian/Cocos

+06:30

Antarctica/Davis

+07:00

Asia/Bangkok

+07:00

Asia/Barnaul

+07:00

Asia/Ho_Chi_Minh

+07:00

Asia/Hovd

+07:00

Asia/Jakarta

+07:00

Asia/Krasnoyarsk

+07:00

Asia/Novokuznetsk

+07:00

Asia/Novosibirsk

+07:00

Asia/Pontianak

+07:00

Asia/Tomsk

+07:00

Etc/GMT-7

+07:00

Indian/Christmas

+07:00

Antarctica/Casey

+08:00

Asia/Brunei

+08:00

Asia/Choibalsan

+08:00

Asia/Hong_Kong

+08:00

Asia/Irkutsk

+08:00

Asia/Kuala_Lumpur

+08:00

Asia/Kuching

+08:00

Asia/Macau

+08:00

Asia/Makassar

+08:00

Asia/Manila

+08:00

Asia/Shanghai

+08:00

Asia/Singapore

+08:00

Asia/Taipei

+08:00

Asia/Ulaanbaatar

+08:00

Australia/Perth

+08:00

Etc/GMT-8

+08:00

Australia/Eucla

+08:45

Asia/Chita

+09:00

Asia/Dili

+09:00

Asia/Jayapura

+09:00

Asia/Khandyga

+09:00

Asia/Pyongyang

+09:00

Asia/Seoul

+09:00

Asia/Tokyo

+09:00

Asia/Yakutsk

+09:00

Etc/GMT-9

+09:00

Pacific/Palau

+09:00

Australia/Adelaide

+09:30

Australia/Broken_Hill

+09:30

Australia/Darwin

+09:30

Antarctica/DumontDUrville

+10:00

Asia/Ust-Nera

+10:00

Asia/Vladivostok

+10:00

Australia/Brisbane

+10:00

Australia/Currie

+10:00

Australia/Hobart

+10:00

Australia/Lindeman

+10:00

Australia/Melbourne

+10:00

Australia/Sydney

+10:00

Etc/GMT-10

+10:00

Pacific/Chuuk

+10:00

Pacific/Guam

+10:00

Pacific/Port_Moresby

+10:00

Australia/Lord_Howe

+10:30

Antarctica/Macquarie

+11:00

Asia/Magadan

+11:00

Asia/Sakhalin

+11:00

Asia/Srednekolymsk

+11:00

Etc/GMT-11

+11:00

Pacific/Bougainville

+11:00

Pacific/Efate

+11:00

Pacific/Guadalcanal

+11:00

Pacific/Kosrae

+11:00

Pacific/Norfolk

+11:00

Pacific/Noumea

+11:00

Pacific/Pohnpei

+11:00

Asia/Anadyr

+12:00

Asia/Kamchatka

+12:00

Etc/GMT-12

+12:00

Pacific/Auckland

+12:00

Pacific/Fiji

+12:00

Pacific/Funafuti

+12:00

Pacific/Kwajalein

+12:00

Pacific/Majuro

+12:00

Pacific/Nauru

+12:00

Pacific/Tarawa

+12:00

Pacific/Wake

+12:00

Pacific/Wallis

+12:00

Pacific/Chatham

+12:45

Etc/GMT-13

+13:00

Pacific/Apia

+13:00

Pacific/Enderbury

+13:00

Pacific/Fakaofo

+13:00

Pacific/Tongatapu

+13:00

Etc/GMT-14

+14:00

Pacific/Kiritimati

+14:00