Skip to main content


This guide will help you understand how to use the Naas scheduler to automate your data jobs.

Cron Tasks

We utilize CRON tasks to schedule notebooks. To understand the syntax of CRON tasks, please visit Crontab Guru.


A single job should not exceed one hour. If it does, consider splitting your work into smaller tasks, or contact us for a specific machine setup.

Timezone Information

By default, the scheduler operates in the Central European Time (CET) timezone. If you are in a different timezone, please use the Timezone low-code formula to synchronize your server with your local timezone.

Scheduling a Notebook

To schedule a notebook, use the add function. For example, to run a notebook every day at 9:00am :

naas.scheduler.add(cron="0 9 * * *")

You can also specify a different notebook by providing a path:

naas.scheduler.add(path="path/to/your/notebook.ipynb", cron="0 9 * * *")

Notification Parameters

  • notif_down: Receive an email when the notebook run fails.
  • notif_up: Receive an email when the notebook runs successfully.
  • next_url: A URL to be called when the notebook runs successfully. This can be any service, even a Notebook API.
params = {"notif_down": "[email protected]", "notif_up": "[email protected]"}

naas.scheduler.add(cron="0 9 * * *", params=params)

For debugging purposes, you can use the debug parameter:

naas.scheduler.add(cron="0 9 * * *", debug=True)

Removing a Schedule

To delete a schedule, use the delete function:


To delete a schedule for a specific notebook:


For debugging:


Listing Schedules

To see all versions of a notebook that have been scheduled, use the list function:


To list versions of a specific notebook:


Retrieving a Schedule

To get the latest version of a scheduled notebook:


To get a specific version of a notebook:


To get a specific version by its history ID:


Clearing Schedules

To clear a specific version of a scheduled notebook:


To clear a specific version of a specific notebook:

naas.scheduler.clear(path="path/to/your/notebook.ipynb", histo="202010081012

Accessing Output

You can fetch the output of the most recent execution of your notebook:


To fetch the output of a specific notebook:


Clearing Output

To clear the output from the latest execution of your notebook:


To clear the output from a specific notebook:


Viewing Your Schedules

If you need a quick overview of all your scheduled notebooks, you can use the currents() function:


For a more detailed, raw view of your scheduled notebooks, you can set the raw parameter to True:


This information provides a comprehensive view of your scheduled tasks, helping you manage your automated notebook tasks effectively.