Scheduled Forecasts

Scheduled Forecasts

You can now create recurring forecast schedules that run automatically and deliver results via webhook. Full CRUD operations let you manage schedules programmatically.

Creating a schedule

curl -X POST https://api.tsfm.ai/v1/schedules \
  -H "Authorization: Bearer $TSFM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hourly energy forecast",
    "model": "chronos-bolt-small",
    "cron": "0 * * * *",
    "source_url": "https://example.com/data.csv",
    "prediction_length": 24,
    "callback_url": "https://example.com/webhook/forecast"
  }'

Features

• Cron expressions — Standard 5-field cron syntax for flexible scheduling
• Source URL — TSFM.ai fetches fresh data from your endpoint before each run
• Webhook delivery — Forecast results are POSTed to your callback_url as soon as they are ready
• Pause/resume — Temporarily disable a schedule without deleting it
• Run history — View past executions, their status, and results

Management endpoints

Method	Endpoint	Description
GET	/v1/schedules	List all schedules
GET	/v1/schedules/:id	Get schedule details
POST	/v1/schedules	Create a new schedule
PATCH	/v1/schedules/:id	Update a schedule
DELETE	/v1/schedules/:id	Delete a schedule
POST	/v1/schedules/:id/pause	Pause a schedule
POST	/v1/schedules/:id/resume	Resume a schedule

Scheduled forecasts are available on Pro and Enterprise plans.