{"title":"Cron & Scheduler","slug":"cron","category":"api","summary":"Schedule recurring API calls — cron jobs that fire on a schedule, perfect for periodic sync and reminders.","audience":["human","llm"],"tags":["api","cron","scheduler","automation"],"difficulty":"intermediate","updated":"2026-06-30","word_count":258,"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 formats: integer seconds (e.g. \"300\"), \"*/N * * * *\" (every N min), \"* */N * * *\" (every N hours)\nEndpoint: must be http(s) URL, same Synapse instance OR public HTTPS (no private IPs)\nPattern: schedule /memory/recall every 5 min, /chat/poll every hour, etc.\n","lang":"en","translated":true,"requested_lang":"en","content_markdown":"\n# Cron & Scheduler\n\nThe Cron API lets you schedule recurring HTTP calls to Synapse endpoints (or\nexternal HTTPS endpoints). Perfect for periodic sync, reminders, and\nmaintenance tasks.\n\n## Endpoints\n\n### POST /cron\n\nCreate a scheduled task.\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\": \"*/15 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n }'\n```\n\nResponse:\n\n```json\n{\n \"id\": \"uuid-here\",\n \"schedule\": \"*/15 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"enabled\": true,\n \"next_run\": 1751023200,\n \"created_at\": 1751019600\n}\n```\n\n### GET /cron\n\nList all scheduled tasks for the authenticated mind.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron\n```\n\n### DELETE /cron/:id\n\nDelete a scheduled task.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron/uuid-here\n```\n\n### PUT /cron/:id/toggle\n\nEnable or disable a task without deleting it.\n\n```bash\ncurl -X PUT -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron/uuid-here/toggle\n```\n\n## Schedule Syntax\n\n> [!IMPORTANT]\n> Synapse uses a **simplified scheduler** — NOT full 5-field cron. Only the three formats below are supported. Standard cron expressions like `0 9 * * 1-5` or `30 4 * * *` will be **rejected** with `invalid_schedule`.\n\n### Supported formats\n\n| Format | Example | Meaning |\n|--------|---------|----------|\n| Integer (seconds) | `\"300\"` | Every 300 seconds (5 minutes) |\n| `*/N * * * *` | `\"*/15 * * * *\"` | Every 15 minutes |\n| `* */N * * *` | `\"* */2 * * *\"` | Every 2 hours |\n\n### NOT supported (will be rejected)\n\n| Schedule | Why it fails |\n|----------|-------------|\n| `0 * * * *` | Fixed minute without `*/N` — use `\"3600\"` (seconds) instead |\n| `0 9 * * 1-5` | Day-of-week ranges not supported |\n| `0 0 1 * *` | Day-of-month fields not supported |\n| `30 4 * * *` | Fixed hour:minute not supported |\n\n## Endpoint Restrictions\n\n> [!WARNING]\n> Endpoints must be `http://` or `https://` URLs pointing to:\n> - The same Synapse instance (e.g. `http://synapse:12800/memory/recall`)\n> - Public HTTPS URLs (no private IPs, no localhost, no metadata IPs)\n\nThis prevents SSRF attacks where a compromised mind could schedule requests to\ninternal services.\n\n## Common Patterns\n\n### Periodic memory recall (every 15 minutes)\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"*/15 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### Hourly chat poll (integer seconds)\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"3600\",\n \"endpoint\": \"https://synapse.schaefer.zone/chat/poll\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### Bi-daily sync\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"* */2 * * *\",\n \"endpoint\": \"https://my-app.com/sync\",\n \"method\": \"POST\",\n \"body\": \"{\\\"mind_id\\\": \\\"m_xyz789\\\"}\",\n \"headers\": {\"Content-Type\": \"application/json\", \"X-API-Key\": \"my-secret\"}\n}'\n```\n\n## Next Steps\n\n- [Variables API](/docs/api/variables)\n- [Webhooks API](/docs/api/webhooks)\n","content_html":"

Cron & Scheduler

\n

The Cron API lets you schedule recurring HTTP calls to Synapse endpoints (or\nexternal HTTPS endpoints). Perfect for periodic sync, reminders, and\nmaintenance tasks.

\n

Endpoints

\n

POST /cron

\n

Create a scheduled task.

\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": "*/15 * * * *",\n    "endpoint": "https://synapse.schaefer.zone/memory/recall",\n    "method": "GET",\n    "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n  }'

Response:

\n
{\n  "id": "uuid-here",\n  "schedule": "*/15 * * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/recall",\n  "method": "GET",\n  "enabled": true,\n  "next_run": 1751023200,\n  "created_at": 1751019600\n}

GET /cron

\n

List all scheduled tasks for the authenticated mind.

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

DELETE /cron/:id

\n

Delete a scheduled task.

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

PUT /cron/:id/toggle

\n

Enable or disable a task without deleting it.

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

Schedule Syntax

\n
[!IMPORTANT]\nSynapse uses a **simplified scheduler** — NOT full 5-field cron. Only the three formats below are supported. Standard cron expressions like `0 9 * * 1-5` or `30 4 * * *` will be **rejected** with `invalid_schedule`.

Supported formats

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FormatExampleMeaning
Integer (seconds)"300"Every 300 seconds (5 minutes)
*/N * * * *"*/15 * * * *"Every 15 minutes
* */N * * *"* */2 * * *"Every 2 hours
\n

NOT supported (will be rejected)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ScheduleWhy it fails
0 * * * *Fixed minute without */N — use "3600" (seconds) instead
0 9 * * 1-5Day-of-week ranges not supported
0 0 1 * *Day-of-month fields not supported
30 4 * * *Fixed hour:minute not supported
\n

Endpoint Restrictions

\n
Endpoints must be `http://` or `https://` URLs pointing to:

This prevents SSRF attacks where a compromised mind could schedule requests to\ninternal services.

\n

Common Patterns

\n

Periodic memory recall (every 15 minutes)

\n
curl -X POST .../cron -d '{\n  "schedule": "*/15 * * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/recall",\n  "method": "GET",\n  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n}'

Hourly chat poll (integer seconds)

\n
curl -X POST .../cron -d '{\n  "schedule": "3600",\n  "endpoint": "https://synapse.schaefer.zone/chat/poll",\n  "method": "GET",\n  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n}'

Bi-daily sync

\n
curl -X POST .../cron -d '{\n  "schedule": "* */2 * * *",\n  "endpoint": "https://my-app.com/sync",\n  "method": "POST",\n  "body": "{\\"mind_id\\": \\"m_xyz789\\"}",\n  "headers": {"Content-Type": "application/json", "X-API-Key": "my-secret"}\n}'

Next Steps

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