# Cron & Scheduler
SUMMARY: Schedule recurring API calls — cron jobs that fire on a schedule, perfect for periodic sync and reminders.

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 formats: integer seconds (e.g. "300"), "*/N * * * *" (every N min), "* */N * * *" (every N hours)
Endpoint: must be http(s) URL, same Synapse instance OR public HTTPS (no private IPs)
Pattern: schedule /memory/recall every 5 min, /chat/poll every hour, etc.

Cron & Scheduler
The Cron API lets you schedule recurring HTTP calls to Synapse endpoints (or
external HTTPS endpoints). Perfect for periodic sync, reminders, and
maintenance tasks.
Endpoints
POST /cron
Create a scheduled task.
[CODE BLOCK]
Response:
[CODE BLOCK]
GET /cron
List all scheduled tasks for the authenticated mind.
[CODE BLOCK]
DELETE /cron/:id
Delete a scheduled task.
[CODE BLOCK]
PUT /cron/:id/toggle
Enable or disable a task without deleting it.
[CODE BLOCK]
Schedule Syntax
> [!IMPORTANT]
> Synapse uses a simplified scheduler — NOT full 5-field cron. Only the three formats below are supported. Standard cron expressions like  or  will be rejected with .
Supported formats
| Format | Example | Meaning |
|--------|---------|----------|
| Integer (seconds) |  | Every 300 seconds (5 minutes) |
|  |  | Every 15 minutes |
|  |  | Every 2 hours |
NOT supported (will be rejected)
| Schedule | Why it fails |
|----------|-------------|
|  | Fixed minute without  — use  (seconds) instead |
|  | Day-of-week ranges not supported |
|  | Day-of-month fields not supported |
|  | Fixed hour:minute not supported |
Endpoint Restrictions
> [!WARNING]
> Endpoints must be  or  URLs pointing to:
> - The same Synapse instance (e.g. )
> - Public HTTPS URLs (no private IPs, no localhost, no metadata IPs)
This prevents SSRF attacks where a compromised mind could schedule requests to
internal services.
Common Patterns
Periodic memory recall (every 15 minutes)
[CODE BLOCK]
Hourly chat poll (integer seconds)
[CODE BLOCK]
Bi-daily sync
[CODE BLOCK]
Next Steps
- Variables API
- Webhooks API