Skip to main content
Version: v4.5

Orchestrator schedules

As well as manually triggering an orchestrator, you can schedule an orchestrator to run periodically or once at a specific time.

An orchestrator schedule is an object with properties that define the id of the orchestrator to schedule, the run interval, and any parameters you want to pass to the orchestrator during invocation that will overwrite the default parameters.


{  "_orchid":"b07990cf-c64d-4cc4-a0bc-02a4daf0510d",  "runinterval":"* * 30",  "_actualParams": {    <your key-pair values to overwrite default     component parameters during invocation>  }}
ParameterTypeDescriptionRequired
_orchidStringThe id of the orchestrator you want to schedule.Required
runintervalStringThe run interval in the style of a chrontab time specification, * * *. The astericks represent seconds from 30 to 59, minutes from 1 to 59, and hours from 1 to 24.Optional
_actualParamsObjectAn object that contains key-pair parameters that you want to overwrite the default orchestrator parameters.Optional

Orchestrator instance queues#

You can queue one instance of a scheduled run at a time – you can only queue the next schedule run if the previous run is completed, cancelled, or stops due to an error.

You can schedule the orchestrator when you create it or from an API call. You can also edit or delete orchestrator schedules.

Orchestrator schedule APIs#

You can create, update, delete, or get orchestrator schedules with the JavaScript platform API, IafDataSource, or the Datasource Service REST API.