Skip to main content
Run cron-based jobs in AgentOS with built-in schedule management and run history. 
pip install agno[scheduler]

from agno.agent import Agent
from agno.db.postgres import PostgresDb
from agno.models.openai import OpenAIChat
from agno.os import AgentOS

db = PostgresDb(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai")

greeter = Agent(
    id="greeter",
    model=OpenAIChat(id="gpt-4o-mini"),
    instructions=["Reply with a short greeting."],
    db=db,
)

app = AgentOS(
    agents=[greeter],
    db=db,
    scheduler=True,
    scheduler_poll_interval=15,
).get_app()

​
Create Schedule

Create a schedule with the Scheduler API: 
curl -X POST http://localhost:7777/schedules \
  -H "Content-Type: application/json" \
  -d '{
    "name": "greeting-every-5m",
    "cron_expr": "*/5 * * * *",
    "endpoint": "/agents/greeter/runs",
    "method": "POST",
    "payload": {"message": "Say hello"},
    "timezone": "UTC",
    "max_retries": 2,
    "retry_delay_seconds": 30
  }'
Create a schedule using the AgentOS UI:
Create Schedule dialog in AgentOS

​
Managing Schedules

Manage execution schedules via the AgentOS Control Panel. Select any row entry in the Scheduler details panel to view configuration details and run history.
Schedule list with run history panel
Edit schedule configuration, enable or disable schedule , trigger it manually or delete it.
Schedule detail panel with configuration

​
Key Concepts

ConceptDescription
CronStandard 5-field cron syntax: minute hour day-of-month month day-of-week
EndpointPath only (for example /agents/greeter/runs), not a full URL
TimezoneIANA timezone string, defaults to UTC
Retriesmax_retries and retry_delay_seconds control failure retries
Run historyEach execution stores status, timing, input, output, and errors

​
Scheduler API

OperationEndpoint
Create schedulePOST /schedules
List schedulesGET /schedules
Get scheduleGET /schedules/{schedule_id}
Update schedulePATCH /schedules/{schedule_id}
Delete scheduleDELETE /schedules/{schedule_id}
Enable or disablePOST /schedules/{schedule_id}/enable and POST /schedules/{schedule_id}/disable
Trigger nowPOST /schedules/{schedule_id}/trigger
List runsGET /schedules/{schedule_id}/runs
Get runGET /schedules/{schedule_id}/runs/{run_id}

​
Next Steps

TaskGuide
Start with a minimal setupBasic Schedule
Manage schedules with RESTSchedule Management
Check request and response schemasSchedule API schemas
Explore all scheduler examplesScheduler Examples