Scheduling job sequences

You can configure your job sequences to run on a schedule. For example every 12 hours, or everyday at 9AM. Job sequences are scheduled upon creation using the schedule and cronExpression parameters.

Here's an example request body payload to create a job sequence, where the job sequence is scheduled to run every 12 hours:

{
  "tenantId": "100",
  "flowName": "ExampleJobSequence",
  "flowId": "ExampleJobSequence",
  "description": "This is an example job sequence. Note the cronExpression.",
  "active": true,
  "jobs": [
    {
      "jobId": "CXU_JOB_1604904383636",
      "id": "Ingest job",
      "type": "INGEST",
      "depends": [
        
      ]
    },
    {
      "jobId": "Dw",
      "id": "Data warehouse job",
      "type": "DW",
      "depends": [
        "Ingest job"
      ]
    }
  ],
  "schedule": {
    "cronExpression": "0 0 0/12 1/1 * ? *"
  }
}

Note the date and time for the job sequence schedule is expressed using the cronExpression parameter as a Cron Expression.

About the schedule parameter

The following table provides more information about the parameters contained within the schedule object.

Name

Type

Description

cronExpression string

Date and time for the job sequence to run, expressed as a Cron Expression. You can build your Cron Expression using tools such as CronMaker and FreeFormatter.

For example:

  • Run the job sequence every 12 hours:

    "schedule": {
      "cronExpression": "0 0 0/12 1/1 * ? *"
    }
  • Run the job sequence daily at 9AM:

    "schedule": {
      "cronExpression": "0 0 9 1/1 * ? *"
    }

Using Cron Expressions

Cron Expressions are a date/time format. You can build your Cron Expression using tools such as FreeFormatter and CronMaker.

Examples

Schedule a job sequence to run every 12 hours:

"schedule": {
  "cronExpression": "0 0 0/12 1/1 * ? *"
}

Schedule a job sequence to run daily at 9AM:

"schedule": {
  "cronExpression": "0 0 9 1/1 * ? *"
}

Schedule a job sequence to run every Monday at noon:

"schedule": {
  "cronExpression": "0 0 12 ? * MON"
}

Next steps

Creating job sequence conditions

Configuring job sequence notifications