# Cron & Scheduler
SUMMARY: Lên lịch các cuộc gọi API định kỳ — cron job kích hoạt theo lịch, hoàn hảo cho đồng bộ và nhắc nhở định kỳ.

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 & Scheduler
Cron API cho phép bạn lên lịch các cuộc gọi HTTP định kỳ đến các endpoint của
Synapse (hoặc các endpoint HTTPS bên ngoài). Hoàn hảo cho đồng bộ định kỳ,
nhắc nhở và các tác vụ bảo trì.
Các endpoint
POST /cron
Tạo một tác vụ đã lên lịch.
[CODE BLOCK]
Phản hồi:
[CODE BLOCK]
GET /cron
Liệt kê tất cả tác vụ đã lên lịch.
[CODE BLOCK]
DELETE /cron/:id
Xóa một tác vụ đã lên lịch.
[CODE BLOCK]
PUT /cron/:id/toggle
Bật hoặc tắt một tác vụ mà không xóa nó.
[CODE BLOCK]
Cú pháp lịch
Cron chuẩn (5 trường)
[CODE BLOCK]
Ví dụ:
| Lịch | Ý nghĩa |
|----------|---------|
|  | Mỗi giờ |
|  | Mỗi 15 phút |
|  | Ngày trong tuần lúc 9 giờ sáng |
|  | Mỗi Chủ nhật lúc nửa đêm |
|  | Ngày đầu tiên mỗi tháng lúc nửa đêm |
Khoảng cách nguyên (giây)
Đối với các khoảng cách đơn giản, truyền một số nguyên:
[CODE BLOCK]
Giới hạn endpoint
> [!WARNING]
> Các endpoint phải là URL  hoặc  trỏ đến:
> - Cùng thể hiện Synapse (ví dụ )
> - URL HTTPS công khai (không IP riêng, không localhost, không IP metadata)
Điều này ngăn chặn các cuộc tấn công SSRF khi một mind bị xâm phạm có thể lên
lịch các yêu cầu đến dịch vụ nội bộ.
Các mẫu phổ biến
Thu hồi bộ nhớ hàng giờ (cho LLM agent)
[CODE BLOCK]
Sao lưu hàng ngày
[CODE BLOCK]
Poll chat định kỳ (mỗi 5 phút)
[CODE BLOCK]
Kích hoạt báo cáo hàng tuần
[CODE BLOCK]
Bước tiếp theo
- Variables API
- Webhooks API