# Cron & Scheduler
SUMMARY: Pianifica chiamate API ricorrenti — cron job che si attivano secondo una pianificazione, perfetti per sync periodici e promemoria.

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
La Cron API permette di pianificare chiamate HTTP ricorrenti agli endpoint di
Synapse (o a endpoint HTTPS esterni). Perfetta per sync periodici, promemoria e
attività di manutenzione.
Endpoint
POST /cron
Crea un'attività pianificata.
[CODE BLOCK]
Risposta:
[CODE BLOCK]
GET /cron
Elenca tutte le attività pianificate.
[CODE BLOCK]
DELETE /cron/:id
Elimina un'attività pianificata.
[CODE BLOCK]
PUT /cron/:id/toggle
Abilita o disabilita un'attività senza eliminarla.
[CODE BLOCK]
Sintassi della pianificazione
Cron standard (5 campi)
[CODE BLOCK]
Esempi:
| Pianificazione | Significato |
|----------|---------|
|  | Ogni ora |
|  | Ogni 15 minuti |
|  | Giorni feriali alle 9:00 |
|  | Ogni domenica a mezzanotte |
|  | Il primo di ogni mese a mezzanotte |
Intervallo intero (secondi)
Per intervalli semplici, passi un intero:
[CODE BLOCK]
Restrizioni sugli endpoint
> [!WARNING]
> Gli endpoint devono essere URL  o  che puntano a:
> - La stessa istanza Synapse (es. )
> - URL HTTPS pubblici (no IP privati, no localhost, no IP di metadata)
Questo previene attacchi SSRF in cui una mente compromessa potrebbe pianificare
richieste a servizi interni.
Modelli comuni
Richiamo memoria orario (per agenti LLM)
[CODE BLOCK]
Backup giornaliero
[CODE BLOCK]
Polling chat periodico (ogni 5 minuti)
[CODE BLOCK]
Attivazione report settimanale
[CODE BLOCK]
Prossimi passi
- API Variables
- API Webhooks