Scheduling

AgentOS can run your hosted agents on a schedule — no external cron infrastructure needed.

---

Setting up a schedule

1. Open an agent in the dashboard
2. Go to the Schedule tab
3. Choose a frequency: hourly, daily, weekly, or a custom cron expression
4. Save — AgentOS will invoke the agent automatically at each interval

Scheduled runs appear in the runs list with trigger_type: scheduled and are included in daily and weekly reports.

---

Cron expressions

Use standard 5-field cron syntax:

┌──────── minute (0–59)
│ ┌────── hour (0–23, UTC)
│ │ ┌──── day of month (1–31)
│ │ │ ┌── month (1–12)
│ │ │ │ ┌ day of week (0–6, Sun=0)
│ │ │ │ │
* * * * *

Expression	Meaning
0 9 * * 1-5	Every weekday at 9:00 UTC
0 * * * *	Every hour
0 8 * * 1	Every Monday at 8:00 UTC
*/15 * * * *	Every 15 minutes

All times are UTC.

---

Passing input to scheduled runs

Set a default input payload on the agent's Schedule tab. AgentOS passes it as the run input on every scheduled invocation.

{
  "report_type": "daily_summary",
  "notify_slack": true
}

---

Prompt variable values for scheduled runs

If the agent uses prompt variables, you can set their values on the Schedule tab under Variable values. AgentOS injects them into the system prompt on every scheduled run — no need to pass them at invoke time.

{
  "SHEET_ID": "1pjdT1FADq-...",
  "NOTIFY_EMAIL": "team@example.com"
}

---

Triggering a run manually

You can trigger any agent run from the dashboard (Agent → Run now) or via the API:

curl -X POST https://agentos-ai.dev/api/v1/agents/<agentId>/invoke \
  -H "Authorization: Bearer aos_agent_..." \
  -H "Content-Type: application/json" \
  -d '{ "input": { "report_type": "on_demand" } }'

---

Monitoring scheduled runs

The Monitor page shows live events from all running agents. The Overview dashboard shows run counts and success rates over the last 24 hours, broken down by agent.

If a scheduled run fails, an alert is raised automatically if you have failure alert rules configured.