# Cron & Agendador
SUMMARY: Agende chamadas recorrentes de API — cron jobs que disparam em horários programados, perfeitos para sincronização periódica e lembretes.

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 & Agendador
A API de Cron permite agendar chamadas HTTP recorrentes para endpoints do
Synapse (ou endpoints HTTPS externos). Perfeita para sincronização periódica,
lembretes e tarefas de manutenção.
Endpoints
POST /cron
Cria uma tarefa agendada.
[CODE BLOCK]
Resposta:
[CODE BLOCK]
GET /cron
Lista todas as tarefas agendadas.
[CODE BLOCK]
DELETE /cron/:id
Exclui uma tarefa agendada.
[CODE BLOCK]
PUT /cron/:id/toggle
Ativa ou desativa uma tarefa sem excluí-la.
[CODE BLOCK]
Sintaxe de agendamento
Cron padrão (5 campos)
[CODE BLOCK]
Exemplos:
| Agendamento | Significado |
|-------------|-------------|
|  | A cada hora |
|  | A cada 15 minutos |
|  | Dias úteis às 9h |
|  | Todo domingo à meia-noite |
|  | Primeiro dia de cada mês à meia-noite |
Intervalo inteiro (segundos)
Para intervalos simples, passe um inteiro:
[CODE BLOCK]
Restrições de endpoint
> [!WARNING]
> Endpoints devem ser URLs  ou  apontando para:
> - A mesma instância do Synapse (ex.: )
> - URLs HTTPS públicas (sem IPs privados, sem localhost, sem IPs de metadata)
Isso evita ataques SSRF onde um mind comprometido pudesse agendar requisições
para serviços internos.
Padrões comuns
Recall de memória por hora (para agentes LLM)
[CODE BLOCK]
Backup diário
[CODE BLOCK]
Poll de chat periódico (a cada 5 minutos)
[CODE BLOCK]
Gatilho de relatório semanal
[CODE BLOCK]
Próximos passos
- API de Variáveis
- API de Webhooks