{"title":"Cron & Scheduler","slug":"cron","category":"api","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ỳ.","audience":["human","llm"],"tags":["api","cron","scheduler","automation"],"difficulty":"intermediate","updated":"2026-06-27","word_count":284,"read_minutes":1,"llm_context":"Auth: Mind Key\nCreate: POST /cron { schedule, endpoint, method?, body?, headers?, enabled? }\nList: GET /cron\nDelete: DELETE /cron/:id\nToggle: PUT /cron/:id/toggle\nSchedule: 5-field cron (minute hour day month day-of-week) OR integer interval (seconds)\nEndpoint: must be http(s) URL, same Synapse instance OR public HTTPS (no private IPs)\nPattern: schedule /memory/recall every hour, /chat/poll every 5 min, etc.\n","lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Cron & Scheduler\n\nCron 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\nSynapse (hoặc các endpoint HTTPS bên ngoài). Hoàn hảo cho đồng bộ định kỳ,\nnhắc nhở và các tác vụ bảo trì.\n\n## Các endpoint\n\n### POST /cron\n\nTạo một tác vụ đã lên lịch.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/cron \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"schedule\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n }'\n```\n\nPhản hồi:\n\n```json\n{\n \"id\": \"cron_001\",\n \"schedule\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"enabled\": true,\n \"next_run\": \"2026-06-27T13:00:00Z\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n### GET /cron\n\nLiệt kê tất cả tác vụ đã lên lịch.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron\n```\n\n### DELETE /cron/:id\n\nXóa một tác vụ đã lên lịch.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron/cron_001\n```\n\n### PUT /cron/:id/toggle\n\nBật hoặc tắt một tác vụ mà không xóa nó.\n\n```bash\ncurl -X PUT -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron/cron_001/toggle\n```\n\n## Cú pháp lịch\n\n### Cron chuẩn (5 trường)\n\n```\n┌───── minute (0-59)\n│ ┌───── hour (0-23)\n│ │ ┌───── day of month (1-31)\n│ │ │ ┌───── month (1-12)\n│ │ │ │ ┌───── day of week (0-6, 0=Sunday)\n│ │ │ │ │\n* * * * *\n```\n\nVí dụ:\n\n| Lịch | Ý nghĩa |\n|----------|---------|\n| `0 * * * *` | Mỗi giờ |\n| `*/15 * * * *` | Mỗi 15 phút |\n| `0 9 * * 1-5` | Ngày trong tuần lúc 9 giờ sáng |\n| `0 0 * * 0` | Mỗi Chủ nhật lúc nửa đêm |\n| `0 0 1 * *` | Ngày đầu tiên mỗi tháng lúc nửa đêm |\n\n### Khoảng cách nguyên (giây)\n\nĐối với các khoảng cách đơn giản, truyền một số nguyên:\n\n```json\n{ \"schedule\": \"300\" } // Every 5 minutes\n```\n\n## Giới hạn endpoint\n\n> [!WARNING]\n> Các endpoint phải là URL `http://` hoặc `https://` trỏ đến:\n> - Cùng thể hiện Synapse (ví dụ `http://synapse:12800/memory/recall`)\n> - URL HTTPS công khai (không IP riêng, không localhost, không IP metadata)\n\nĐ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\nlịch các yêu cầu đến dịch vụ nội bộ.\n\n## Các mẫu phổ biến\n\n### Thu hồi bộ nhớ hàng giờ (cho LLM agent)\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### Sao lưu hàng ngày\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 2 * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/mind-export\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### Poll chat định kỳ (mỗi 5 phút)\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"300\",\n \"endpoint\": \"https://synapse.schaefer.zone/chat/poll\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### Kích hoạt báo cáo hàng tuần\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 9 * * 1\",\n \"endpoint\": \"https://my-app.com/weekly-report\",\n \"method\": \"POST\",\n \"body\": \"{\\\"mind_id\\\": \\\"m_xyz789\\\"}\",\n \"headers\": {\"Content-Type\": \"application/json\", \"X-API-Key\": \"my-secret\"}\n}'\n```\n\n## Bước tiếp theo\n\n- [Variables API](/docs/api/variables)\n- [Webhooks API](/docs/api/webhooks)\n","content_html":"

Cron & Scheduler

\n

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\nSynapse (hoặc các endpoint HTTPS bên ngoài). Hoàn hảo cho đồng bộ định kỳ,\nnhắc nhở và các tác vụ bảo trì.

\n

Các endpoint

\n

POST /cron

\n

Tạo một tác vụ đã lên lịch.

\n
curl -X POST https://synapse.schaefer.zone/cron \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "schedule": "0 * * * *",\n    "endpoint": "https://synapse.schaefer.zone/memory/recall",\n    "method": "GET",\n    "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n  }'

Phản hồi:

\n
{\n  "id": "cron_001",\n  "schedule": "0 * * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/recall",\n  "method": "GET",\n  "enabled": true,\n  "next_run": "2026-06-27T13:00:00Z",\n  "created_at": "2026-06-27T..."\n}

GET /cron

\n

Liệt kê tất cả tác vụ đã lên lịch.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/cron

DELETE /cron/:id

\n

Xóa một tác vụ đã lên lịch.

\n
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/cron/cron_001

PUT /cron/:id/toggle

\n

Bật hoặc tắt một tác vụ mà không xóa nó.

\n
curl -X PUT -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/cron/cron_001/toggle

Cú pháp lịch

\n

Cron chuẩn (5 trường)

\n
┌───── minute (0-59)\n│ ┌───── hour (0-23)\n│ │ ┌───── day of month (1-31)\n│ │ │ ┌───── month (1-12)\n│ │ │ │ ┌───── day of week (0-6, 0=Sunday)\n│ │ │ │ │\n* * * * *

Ví dụ:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
LịchÝ nghĩa
0 * * * *Mỗi giờ
*/15 * * * *Mỗi 15 phút
0 9 * * 1-5Ngày trong tuần lúc 9 giờ sáng
0 0 * * 0Mỗi Chủ nhật lúc nửa đêm
0 0 1 * *Ngày đầu tiên mỗi tháng lúc nửa đêm
\n

Khoảng cách nguyên (giây)

\n

Đối với các khoảng cách đơn giản, truyền một số nguyên:

\n
{ "schedule": "300" }  // Every 5 minutes

Giới hạn endpoint

\n
Các endpoint phải là URL `http://` hoặc `https://` trỏ đến:

Đ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\nlịch các yêu cầu đến dịch vụ nội bộ.

\n

Các mẫu phổ biến

\n

Thu hồi bộ nhớ hàng giờ (cho LLM agent)

\n
curl -X POST .../cron -d '{\n  "schedule": "0 * * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/recall",\n  "method": "GET",\n  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n}'

Sao lưu hàng ngày

\n
curl -X POST .../cron -d '{\n  "schedule": "0 2 * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/mind-export",\n  "method": "GET",\n  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n}'

Poll chat định kỳ (mỗi 5 phút)

\n
curl -X POST .../cron -d '{\n  "schedule": "300",\n  "endpoint": "https://synapse.schaefer.zone/chat/poll",\n  "method": "GET",\n  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n}'

Kích hoạt báo cáo hàng tuần

\n
curl -X POST .../cron -d '{\n  "schedule": "0 9 * * 1",\n  "endpoint": "https://my-app.com/weekly-report",\n  "method": "POST",\n  "body": "{\\"mind_id\\": \\"m_xyz789\\"}",\n  "headers": {"Content-Type": "application/json", "X-API-Key": "my-secret"}\n}'

Bước tiếp theo

\n\n","urls":{"html":"/docs/api/cron","text":"/docs/api/cron?format=text","json":"/docs/api/cron?format=json","llm":"/docs/api/cron?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}