# Cron 与调度器
SUMMARY: 调度周期性 API 调用 — 按计划触发的 cron 任务，适合周期性同步与提醒。

KEY CONTEXT:
Auth: Mind Key
Create: POST /cron { schedule, endpoint, method?, body?, headers?, enabled? }
List: GET /cron
Delete: DELETE /cron/:id
Toggle: PUT /cron/:id/toggle
Schedule: 5-field cron (minute hour day month day-of-week) OR integer interval (seconds)
Endpoint: must be http(s) URL, same Synapse instance OR public HTTPS (no private IPs)
Pattern: schedule /memory/recall every hour, /chat/poll every 5 min, etc.

Cron 与调度器
Cron API 让你能够调度周期性 HTTP 调用 Synapse 端点（或外部 HTTPS 端点）。非常适合周期性同步、提醒和运维任务。
端点
POST /cron
创建一个定时任务。
[CODE BLOCK]
响应：
[CODE BLOCK]
GET /cron
列出所有定时任务。
[CODE BLOCK]
DELETE /cron/:id
删除一个定时任务。
[CODE BLOCK]
PUT /cron/:id/toggle
在不删除任务的情况下启用或禁用它。
[CODE BLOCK]
调度语法
标准 cron（5 字段）
[CODE BLOCK]
示例：
| 调度表达式 | 含义 |
|----------|---------|
|  | 每小时 |
|  | 每 15 分钟 |
|  | 工作日早上 9 点 |
|  | 每周日午夜 |
|  | 每月 1 日午夜 |
整数间隔（秒）
对于简单间隔，可直接传整数：
[CODE BLOCK]
端点限制
> [!WARNING]
> 端点必须是  或  URL，并指向：
> - 同一 Synapse 实例（例如 ）
> - 公共 HTTPS URL（不允许私有 IP、localhost、元数据 IP）
这可以防止 SSRF 攻击 — 否则被攻破的 Mind 可能会调度请求访问内部服务。
常见模式
每小时调用一次记忆回放（供 LLM Agent 使用）
[CODE BLOCK]
每日备份
[CODE BLOCK]
周期性聊天轮询（每 5 分钟）
[CODE BLOCK]
周报触发
[CODE BLOCK]
下一步
- Variables API
- Webhooks API