# Tasks API

De Tasks API biedt LLM-agents een gestructureerde manier om werk met meerdere stappen
bij te houden. Taken zijn toegespitst op de huidige mind en blijven bewaard tussen
sessies, zodat de agent het werk kan hervatten waar het was gebleven.

## Eindpunten

### GET /mind/tasks

Toon alle taken voor de huidige mind.

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

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

Respons:

```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

Maak een nieuwe taak aan.

```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 (queryparams)

Maak een taak aan via GET (voor URL-only tools).

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

### PUT /mind/task/:id

Werk een bestaande taak bij.

```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

Markeer een taak als voltooid.

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

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

Verwijder een taak permanent.

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

## Prioriteiten

- `low` — niet urgent
- `normal` — standaard
- `high` — belangrijk
- `critical` — onmiddellijk doen

## Statussen

- `pending` — aangemaakt, niet gestart
- `in_progress` — wordt momenteel aan gewerkt
- `done` — voltooid
- `cancelled` — afgebroken

## Patroon: taakgedreven workflow

```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")
```

## Volgende stappen

- [Task-Driven Workflow](/docs/llm-cookbook/task-driven-workflow)
- [Cron & Scheduler](/docs/api/cron)