{"title":"Cron 및 Scheduler","slug":"cron","category":"api","summary":"반복적인 API 호출 예약 — 주기적 동기화 및 알림에 적합한 cron 작업을 스케줄에 따라 실행합니다.","audience":["human","llm"],"tags":["api","cron","scheduler","automation"],"difficulty":"intermediate","updated":"2026-06-27","word_count":187,"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":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# Cron 및 Scheduler\n\nCron API를 사용하면 Synapse 엔드포인트 (또는 외부 HTTPS 엔드포인트)에 대한\n반복적인 HTTP 호출을 예약할 수 있습니다. 주기적 동기화, 알림 및 유지 관리\n작업에 적합합니다.\n\n## 엔드포인트\n\n### POST /cron\n\n예약된 작업을 생성합니다.\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\n응답:\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\n모든 예약된 작업을 나열합니다.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron\n```\n\n### DELETE /cron/:id\n\n예약된 작업을 삭제합니다.\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\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## 스케줄 구문\n\n### 표준 cron (5개 필드)\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\n예시:\n\n| 스케줄 | 의미 |\n|----------|---------|\n| `0 * * * *` | 매시 정각 |\n| `*/15 * * * *` | 15분마다 |\n| `0 9 * * 1-5` | 평일 오전 9시 |\n| `0 0 * * 0` | 매주 일요일 자정 |\n| `0 0 1 * *` | 매월 1일 자정 |\n\n### 정수 간격 (초)\n\n단순한 간격의 경우 정수를 전달합니다:\n\n```json\n{ \"schedule\": \"300\" } // 5분마다\n```\n\n## 엔드포인트 제한 사항\n\n> [!WARNING]\n> 엔드포인트는 다음을 가리키는 `http://` 또는 `https://` URL이어야 합니다:\n> - 동일한 Synapse 인스턴스 (예: `http://synapse:12800/memory/recall`)\n> - 공용 HTTPS URL (사설 IP, localhost, 메타데이터 IP 불가)\n\n이는 손상된 마인드가 내부 서비스로 요청을 예약하는 SSRF 공격을\n방지합니다.\n\n## 일반적인 패턴\n\n### 시간별 memory recall (LLM 에이전트용)\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### 일일 백업\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### 주기적 채팅 폴링 (5분마다)\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### 주간 보고서 트리거\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## 다음 단계\n\n- [Variables API](/docs/api/variables)\n- [Webhooks API](/docs/api/webhooks)\n","content_html":"

Cron 및 Scheduler

\n

Cron API를 사용하면 Synapse 엔드포인트 (또는 외부 HTTPS 엔드포인트)에 대한\n반복적인 HTTP 호출을 예약할 수 있습니다. 주기적 동기화, 알림 및 유지 관리\n작업에 적합합니다.

\n

엔드포인트

\n

POST /cron

\n

예약된 작업을 생성합니다.

\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  }'

응답:

\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

모든 예약된 작업을 나열합니다.

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

DELETE /cron/:id

\n

예약된 작업을 삭제합니다.

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

PUT /cron/:id/toggle

\n

삭제하지 않고 작업을 활성화 또는 비활성화합니다.

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

스케줄 구문

\n

표준 cron (5개 필드)

\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\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
스케줄의미
0 * * * *매시 정각
*/15 * * * *15분마다
0 9 * * 1-5평일 오전 9시
0 0 * * 0매주 일요일 자정
0 0 1 * *매월 1일 자정
\n

정수 간격 (초)

\n

단순한 간격의 경우 정수를 전달합니다:

\n
{ "schedule": "300" }  // 5분마다

엔드포인트 제한 사항

\n
엔드포인트는 다음을 가리키는 `http://` 또는 `https://` URL이어야 합니다:

이는 손상된 마인드가 내부 서비스로 요청을 예약하는 SSRF 공격을\n방지합니다.

\n

일반적인 패턴

\n

시간별 memory recall (LLM 에이전트용)

\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}'

일일 백업

\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}'

주기적 채팅 폴링 (5분마다)

\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}'

주간 보고서 트리거

\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}'

다음 단계

\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"]}