{"title":"Cron & Scheduler","slug":"cron","category":"api","summary":"Planifiez des appels d'API récurrents — tâches cron qui se déclenchent selon une planification, parfait pour la synchronisation périodique et les rappels.","audience":["human","llm"],"tags":["api","cron","scheduler","automation"],"difficulty":"intermediate","updated":"2026-06-27","word_count":241,"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: 5-field cron (minute hour day month day-of-week) OR integer interval (seconds)\nEndpoint: must be http(s) URL, same Synapse instance OR public HTTPS (no private IPs)\nPattern: schedule /memory/recall every hour, /chat/poll every 5 min, etc.\n","lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Cron & Scheduler\n\nL'API Cron permet de planifier des appels HTTP récurrents vers des endpoints Synapse\n(ou des endpoints HTTPS externes). Parfait pour la synchronisation périodique, les\nrappels et les tâches de maintenance.\n\n## Endpoints\n\n### POST /cron\n\nCrée une tâche planifiée.\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\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n }'\n```\n\nRéponse :\n\n```json\n{\n \"id\": \"cron_001\",\n \"schedule\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"enabled\": true,\n \"next_run\": \"2026-06-27T13:00:00Z\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n### GET /cron\n\nListe toutes les tâches planifiées.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron\n```\n\n### DELETE /cron/:id\n\nSupprime une tâche planifiée.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron/cron_001\n```\n\n### PUT /cron/:id/toggle\n\nActive ou désactive une tâche sans la supprimer.\n\n```bash\ncurl -X PUT -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron/cron_001/toggle\n```\n\n## Syntaxe de planification\n\n### Cron standard (5 champs)\n\n```\n┌───── minute (0-59)\n│ ┌───── hour (0-23)\n│ │ ┌───── day of month (1-31)\n│ │ │ ┌───── month (1-12)\n│ │ │ │ ┌───── day of week (0-6, 0=Sunday)\n│ │ │ │ │\n* * * * *\n```\n\nExemples :\n\n| Planification | Signification |\n|----------|---------|\n| `0 * * * *` | Toutes les heures |\n| `*/15 * * * *` | Toutes les 15 minutes |\n| `0 9 * * 1-5` | En semaine à 9 h |\n| `0 0 * * 0` | Tous les dimanches à minuit |\n| `0 0 1 * *` | Le premier de chaque mois à minuit |\n\n### Intervalle entier (secondes)\n\nPour des intervalles simples, passez un entier :\n\n```json\n{ \"schedule\": \"300\" } // Toutes les 5 minutes\n```\n\n## Restrictions sur les endpoints\n\n> [!WARNING]\n> Les endpoints doivent être des URLs `http://` ou `https://` pointant vers :\n> - La même instance Synapse (ex. `http://synapse:12800/memory/recall`)\n> - Des URLs HTTPS publiques (pas d'IP privées, pas de localhost, pas d'IP de métadonnées)\n\nCela empêche les attaques SSRF où un mind compromis pourrait planifier des requêtes\nvers des services internes.\n\n## Schémas courants\n\n### Rappel mémoire horaire (pour les agents LLM)\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### Sauvegarde quotidienne\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 2 * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/mind-export\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### Polling périodique du chat (toutes les 5 minutes)\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"300\",\n \"endpoint\": \"https://synapse.schaefer.zone/chat/poll\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### Déclencheur de rapport hebdomadaire\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 9 * * 1\",\n \"endpoint\": \"https://my-app.com/weekly-report\",\n \"method\": \"POST\",\n \"body\": \"{\\\"mind_id\\\": \\\"m_xyz789\\\"}\",\n \"headers\": {\"Content-Type\": \"application/json\", \"X-API-Key\": \"my-secret\"}\n}'\n```\n\n## Prochaines étapes\n\n- [API Variables](/docs/api/variables)\n- [API Webhooks](/docs/api/webhooks)\n","content_html":"

Cron & Scheduler

\n

L'API Cron permet de planifier des appels HTTP récurrents vers des endpoints Synapse\n(ou des endpoints HTTPS externes). Parfait pour la synchronisation périodique, les\nrappels et les tâches de maintenance.

\n

Endpoints

\n

POST /cron

\n

Crée une tâche planifiée.

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

Réponse :

\n
{\n  "id": "cron_001",\n  "schedule": "0 * * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/recall",\n  "method": "GET",\n  "enabled": true,\n  "next_run": "2026-06-27T13:00:00Z",\n  "created_at": "2026-06-27T..."\n}

GET /cron

\n

Liste toutes les tâches planifiées.

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

DELETE /cron/:id

\n

Supprime une tâche planifiée.

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

PUT /cron/:id/toggle

\n

Active ou désactive une tâche sans la supprimer.

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

Syntaxe de planification

\n

Cron standard (5 champs)

\n
┌───── minute (0-59)\n│ ┌───── hour (0-23)\n│ │ ┌───── day of month (1-31)\n│ │ │ ┌───── month (1-12)\n│ │ │ │ ┌───── day of week (0-6, 0=Sunday)\n│ │ │ │ │\n* * * * *

Exemples :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PlanificationSignification
0 * * * *Toutes les heures
*/15 * * * *Toutes les 15 minutes
0 9 * * 1-5En semaine à 9 h
0 0 * * 0Tous les dimanches à minuit
0 0 1 * *Le premier de chaque mois à minuit
\n

Intervalle entier (secondes)

\n

Pour des intervalles simples, passez un entier :

\n
{ "schedule": "300" }  // Toutes les 5 minutes

Restrictions sur les endpoints

\n
Les endpoints doivent être des URLs `http://` ou `https://` pointant vers :

Cela empêche les attaques SSRF où un mind compromis pourrait planifier des requêtes\nvers des services internes.

\n

Schémas courants

\n

Rappel mémoire horaire (pour les agents LLM)

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

Sauvegarde quotidienne

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

Polling périodique du chat (toutes les 5 minutes)

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

Déclencheur de rapport hebdomadaire

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

Prochaines étapes

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