# Cron 및 Scheduler
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 및 Scheduler
Cron API를 사용하면 Synapse 엔드포인트 (또는 외부 HTTPS 엔드포인트)에 대한
반복적인 HTTP 호출을 예약할 수 있습니다. 주기적 동기화, 알림 및 유지 관리
작업에 적합합니다.
엔드포인트
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 공격을
방지합니다.
일반적인 패턴
시간별 memory recall (LLM 에이전트용)
[CODE BLOCK]
일일 백업
[CODE BLOCK]
주기적 채팅 폴링 (5분마다)
[CODE BLOCK]
주간 보고서 트리거
[CODE BLOCK]
다음 단계
- Variables API
- Webhooks API