Skip to main content
Function schedules let you run Cognite Functions automatically at defined intervals using cron expressions. Each schedule is linked to a specific function and can include input data that is passed to the function on each execution.

What function schedules do

A schedule defines when a function should run. You specify a cron expression (for example, every hour or every day at midnight) and optionally provide input data. CDF creates a function call according to the schedule, passing the configured input to the function.

Managing schedules

  • Create: Define a new schedule with a cron expression and optional input payload.
  • List: View all schedules for a function or across your project.
  • Delete: Remove a schedule to stop automatic executions.
  • Inspect: Retrieve schedule details including the cron expression and input configuration.
Schedules use standard cron syntax. Ensure your cron expression is valid for your desired execution frequency.

Sessions

A schedule fires asynchronous calls with the input in data and the cadence in a cron expression. Set either functionId or functionExternalId, not both. functionExternalId is deprecated. When you create a schedule with a nonce, you must use functionId. The nonce binds a session before each run, and CDF keeps that session for the life of the schedule.
Do not put secrets in the schedule data object. Store secrets on the function.

Use cases

Use schedules for periodic data syncs, recurring reports, cleanup tasks, or any workflow that should run on a fixed interval. Combine schedules with functions to automate data processing without manual invocation.
Last modified on November 2, 2026