# Tasks API

Tasks API LLM एजेंट्स को बहु-चरणीय कार्य को ट्रैक करने का एक संरचित तरीका देता है। कार्य वर्तमान mind तक सीमित हैं और सत्रों में बने रहते हैं, इसलिए एजेंट जहाँ छोड़ा था वहाँ से काम फिर से शुरू कर सकता है।

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

### GET /mind/tasks

वर्तमान mind के लिए सभी कार्यों की सूची बनाएँ।

```bash
# All tasks
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/tasks

# Filter by status
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/mind/tasks?status=pending"
```

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

```json
{
  "tasks": [
    {
      "id": "task_001",
      "title": "Deploy v1.5.0",
      "description": "Push to production after CI green",
      "priority": "high",
      "status": "in_progress",
      "due_at": "2026-06-28T...",
      "created_at": "2026-06-27T..."
    }
  ]
}
```

### POST /mind/task

नया कार्य बनाएँ।

```bash
curl -X POST https://synapse.schaefer.zone/mind/task \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Update documentation",
    "description": "Add v1.5.0 changelog entries",
    "priority": "normal",
    "due_at": "2026-06-30T00:00:00Z"
  }'
```

### GET /mind/task (क्वेरी पैरामीटर्स)

GET के माध्यम से कार्य बनाएँ (URL-केवल टूल्स के लिए)।

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/mind/task?title=Test+task&priority=high"
```

### PUT /mind/task/:id

मौजूदा कार्य अपडेट करें।

```bash
curl -X PUT https://synapse.schaefer.zone/mind/task/task_001 \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress",
    "description": "Currently deploying, CI is green"
  }'
```

### GET /mind/task/:id/complete

कार्य को पूर्ण चिह्नित करें।

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/task/task_001/complete
```

### GET /mind/task/:id/delete

कार्य को स्थायी रूप से हटाएँ।

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/task/task_001/delete
```

## प्राथमिकताएँ

- `low` — गैर-तात्कालिक
- `normal` — डिफ़ॉल्ट
- `high` — महत्वपूर्ण
- `critical` — तुरंत करना चाहिए

## स्थितियाँ

- `pending` — बनाया गया, शुरू नहीं हुआ
- `in_progress` — वर्तमान में कार्य चल रहा है
- `done` — पूर्ण
- `cancelled` — परित्यक्त

## पैटर्न: कार्य-चालित वर्कफ़्लो

```python
# At session start
tasks = list_tasks(status="in_progress")
if tasks:
    print(f"Resuming: {tasks[0].title}")

# Plan multi-step work
for step in plan:
    task = create_task(title=step)

# Update as you progress
update_task(task.id, status="in_progress")
# ... do work ...
update_task(task.id, status="done")
```

## अगले कदम

- [कार्य-चालित वर्कफ़्लो](/docs/llm-cookbook/task-driven-workflow)
- [Cron और Scheduler](/docs/api/cron)