# Cron & Scheduler
SUMMARY: ตั้งเวลาการเรียก API แบบ recurring — cron jobs ที่ทำงานตามตารางเวลา เหมาะสำหรับ sync และการแจ้งเตือนเป็นคาบ

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 ช่วยให้คุณตั้งเวลาการเรียก HTTP แบบ recurring ไปยัง Synapse endpoint (หรือ external HTTPS endpoint) เหมาะสำหรับ sync เป็นคาบ, การแจ้งเตือน, และงานบำรุงรักษา
Endpoints
POST /cron
สร้าง task ที่ตั้งเวลาไว้
[CODE BLOCK]
Response:
[CODE BLOCK]
GET /cron
รายการ task ที่ตั้งเวลาไว้ทั้งหมด
[CODE BLOCK]
DELETE /cron/:id
ลบ task ที่ตั้งเวลาไว้
[CODE BLOCK]
PUT /cron/:id/toggle
เปิดหรือปิดใช้งาน task โดยไม่ลบ
[CODE BLOCK]
รูปแบบ Schedule
Standard cron (5 fields)
[CODE BLOCK]
ตัวอย่าง:
| Schedule | ความหมาย |
|----------|---------|
|  | ทุกชั่วโมง |
|  | ทุก 15 นาที |
|  | 9 โมงเช้าวันธรรมดา |
|  | เที่ยงคืนทุกวันอาทิตย์ |
|  | เที่ยงคืนวันแรกของทุกเดือน |
Integer interval (วินาที)
สำหรับช่วงเวลาง่าย ๆ ให้ส่ง integer:
[CODE BLOCK]
ข้อจำกัดของ Endpoint
> [!WARNING]
> Endpoint ต้องเป็น URL แบบ  หรือ  ที่ชี้ไปยัง:
> - Synapse instance เดียวกัน (เช่น )
> - Public HTTPS URL (ห้าม private IP, ห้าม localhost, ห้าม metadata IP)
สิ่งนี้ป้องกัน SSRF attack ที่ mind ที่ถูกโจมตีอาจตั้งเวลา request ไปยัง internal service
รูปแบบทั่วไป
การ recall memory รายชั่วโมง (สำหรับ LLM agent)
[CODE BLOCK]
สำรองข้อมูลรายวัน
[CODE BLOCK]
การ poll chat เป็นคาบ (ทุก 5 นาที)
[CODE BLOCK]
ทริกเกอร์รายงานรายสัปดาห์
[CODE BLOCK]
ขั้นตอนถัดไป
- Variables API
- Webhooks API