📅 Scheduler API

Lightweight, Stateless Schedule Pattern Calculation Service

Welcome to the Scheduler API!

This is a pure computation service for schedule pattern calculation and validation. It provides:

Note: This is a stateless service - no persistence, no database, just pure calculation.

API Endpoints

GET /health
Check the service health status and version. Returns service status, timestamp, and version information.

🧪 Try it out:

Test Health Endpoint →
POST /calculate-next-run
Calculate the next run time(s) for a given abstract pattern. Supports human-readable patterns like @daily, @tomorrow@noon, @inaweek+2d@dinner, and more. Returns the next scheduled execution time along with a preview of upcoming runs.

🧪 Try it out:


                    
Response:

                
POST /calculate-next-run-cron
Calculate the next run time(s) for a cron expression. Supports standard 5-field cron format (minute hour day month day-of-week). Returns the next scheduled execution time along with a preview of upcoming runs.

🧪 Try it out:


                    
Response:

                
POST /pattern-to-scheduling
Convert abstract patterns to cron expressions or at commands. Recurring patterns (like @daily, @weekly) export as cron. One-time patterns (like @tomorrow, @inaweek) export as at commands. Great for learning cron/at syntax!

🧪 Try it out:


                    
Response:

                
POST /validate
Validate schedule patterns, cron expressions, datetime strings, or timezones. Returns validation status and contextual information about the input.

🧪 Try it out:


                    
Response:

                
GET /aliases
Discover all available pattern aliases. Lists all day patterns (daily, weekly, today, tomorrow, etc.), time aliases (breakfast, dinner, night, etc.), repeat patterns (once, alternate, half, double, testing, etc.), pattern formats, and usage examples.

🧪 Try it out:

View All Aliases →
GET /terms
Reference all available scheduling terms and their meanings. Shows day terms, time terms, repeat terms, and day abbreviations with human-readable descriptions for quick lookup.

🧪 Try it out:

View All Terms →