# Cron और Scheduler

Cron API आपको Synapse एंडपॉइंट्स (या बाहरी HTTPS एंडपॉइंट्स) पर आवर्ती HTTP कॉल शेड्यूल करने की सुविधा देता है। आवर्ती सिंक, रिमाइंडर और रखरखाव कार्यों के लिए आदर्श।

## एंडपॉइंट्स

### POST /cron

शेड्यूल किया गया कार्य बनाएँ।

```bash
curl -X POST https://synapse.schaefer.zone/cron \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "schedule": "0 * * * *",
    "endpoint": "https://synapse.schaefer.zone/memory/recall",
    "method": "GET",
    "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}
  }'
```

प्रतिक्रिया:

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

### GET /cron

सभी शेड्यूल किए गए कार्यों की सूची बनाएँ।

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

### DELETE /cron/:id

शेड्यूल किए गए कार्य को हटाएँ।

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

### PUT /cron/:id/toggle

कार्य को हटाए बिना सक्षम या अक्षम करें।

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

## शेड्यूल सिंटैक्स

### मानक cron (5 फ़ील्ड्स)

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

उदाहरण:

| शेड्यूल | अर्थ |
|----------|---------|
| `0 * * * *` | हर घंटा |
| `*/15 * * * *` | हर 15 मिनट |
| `0 9 * * 1-5` | सप्ताह के दिन सुबह 9 बजे |
| `0 0 * * 0` | हर रविवार आधी रात को |
| `0 0 1 * *` | हर महीने की पहली तारीख आधी रात को |

### पूर्णांक अंतराल (सेकंड)

सरल अंतरालों के लिए, पूर्णांक पास करें:

```json
{ "schedule": "300" }  // Every 5 minutes
```

## एंडपॉइंट प्रतिबंध

> [!WARNING]
> एंडपॉइंट्स `http://` या `https://` URL होने चाहिए जो निम्न पर संकेत करते हों:
> - उसी Synapse इंस्टेंस (जैसे `http://synapse:12800/memory/recall`)
> - सार्वजनिक HTTPS URL (कोई निजी IP नहीं, कोई localhost नहीं, कोई metadata IP नहीं)

यह SSRF हमलों को रोकता है जहाँ कोई समझौता किया गया mind आंतरिक सेवाओं के लिए अनुरोध शेड्यूल कर सकता है।

## सामान्य पैटर्न

### प्रति घंटा मेमोरी रिकॉल (LLM एजेंट्स के लिए)

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

### दैनिक बैकअप

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

### आवर्ती चैट poll (हर 5 मिनट)

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

### साप्ताहिक रिपोर्ट ट्रिगर

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

## अगले कदम

- [Variables API](/docs/api/variables)
- [Webhooks API](/docs/api/webhooks)