Task scheduling for reminders, follow-ups, and recurring actions.
Schedule tasks to run at specific times or intervals. This is agentic scheduling - the agent decides when and what to schedule.
Schedule a task to run later. Use this for reminders, follow-ups, or recurring actions.
Parameters:
name (string, required): Descriptive name for the taskscheduleType (string, required): Type of schedule
cron - Cron expression (e.g., "0 9 * * 1-5" for weekdays at 9am)interval - Milliseconds between runs (e.g., 300000 for every 5 minutes)once - One-time at specific ISO timestampscheduleValue (string, required): When to runprompt (string, required): What to do when the task runscontext (object, optional): Additional context dataSchedule Types:
| Type |
|---|
| Value Format |
|---|
| Example |
|---|
cron | Cron expression | 0 9 * * 1-5 (weekdays at 9am) |
interval | Milliseconds | 300000 (every 5 minutes) |
once | ISO timestamp | 2026-03-01T10:00:00Z |
Example:
{
"name": "Daily summary reminder",
"scheduleType": "cron",
"scheduleValue": "0 18 * * *",
"prompt": "Send a summary of today's conversations"
}
View all scheduled tasks.
Parameters:
status (string, optional): Filter by "active", "paused", "completed", or "failed"Example:
{
"status": "active"
}
Remove a scheduled task.
Parameters:
taskId (string, required): The task ID to cancelExample:
{
"taskId": "task-123"
}
Temporarily stop or restart a task.
Parameters:
taskId (string, required): The task ID to pause/resumeExample:
{
"taskId": "task-123"
}
Get details of a specific task.
Parameters:
taskId (string, required): The task ID to retrieveExample:
{
"taskId": "task-123"
}
Manually trigger a task to run immediately.
Parameters:
taskId (string, required): The task ID to runExample:
{
"taskId": "task-123"
}
Daily reminders:
{
"name": "Morning check-in",
"scheduleType": "cron",
"scheduleValue": "0 9 * * *",
"prompt": "Send a good morning message"
}
Follow-up after inactivity:
{
"name": "Follow-up reminder",
"scheduleType": "once",
"scheduleValue": "2026-03-15T14:00:00Z",
"prompt": "Check if user has questions about previous discussion"
}
Periodic status checks:
{
"name": "System health check",
"scheduleType": "interval",
"scheduleValue": "300000",
"prompt": "Check system status and report any issues"
}