Scheduled Runs

Automate notebook execution with scheduling, webhooks, and notifications

Scheduled Runs let you automate your notebook execution so it runs without manual intervention.


Free vs Paid Plan

  • Free Plan – Schedule each doc to run up to once per week.
  • Paid Plan – Unlimited scheduling options:
    • Daily, Weekly, or Monthly schedules.
    • Trigger schedules via webhooks from another service — or even another Livedocs notebook.

Creating a Scheduled Run

When creating a schedule, you can:

  1. Set the frequency (daily, weekly, monthly).
  2. Optionally enable webhook triggers.
  3. Choose notification methods for when the run completes.

Webhook Trigger Example

curl --request POST \
  --url https://api.livedocs.com/v1/webhooks/<some-unique-id> \
  --header 'Authorization: Bearer YOUR_WORKSPACE_API_KEY'

Exact code samples are shown in Livedocs when you create the schedule.


Notifications

You can be notified when a scheduled run completes via:

  • Slack – Connect your Slack workspace via OAuth in Workspace Settings.
  • Email – Enter recipient emails directly in the schedule creation modal.
  • Webhook – Provide a URL for Livedocs to POST run details to.

Webhook Notification Details

  • Livedocs sends a POST request with parameters like:
    • doc_id – The ID of the document.
    • Other metadata about the run.
  • The doc_id can be found as the unique characters in the document’s URL.

Tip: Combining webhook triggers and notifications allows you to chain notebook executions across systems.