{"title":"Tasks API","slug":"tasks","category":"api","summary":"Taakbeheer voor LLM-agents — taken aanmaken, tonen, bijwerken, voltooien en verwijderen met prioriteiten.","audience":["human","llm"],"tags":["api","tasks","todo","management"],"difficulty":"beginner","updated":"2026-06-27","word_count":152,"read_minutes":1,"llm_context":"Auth: Mind Key\nList: GET /mind/tasks?status=pending|in_progress|done|cancelled|all\nCreate: POST /mind/task { title, description?, priority?, due_at? }\nUpdate: PUT /mind/task/:id { title?, description?, priority?, status?, due_at? }\nComplete: GET /mind/task/:id/complete\nDelete: GET /mind/task/:id/delete\nPriorities: low, normal, high, critical\nStatuses: pending, in_progress, done, cancelled\nPattern: create tasks for multi-step work, update status as you progress\n","lang":"nl","translated":true,"requested_lang":"nl","content_markdown":"\n# Tasks API\n\nDe Tasks API biedt LLM-agents een gestructureerde manier om werk met meerdere stappen\nbij te houden. Taken zijn toegespitst op de huidige mind en blijven bewaard tussen\nsessies, zodat de agent het werk kan hervatten waar het was gebleven.\n\n## Eindpunten\n\n### GET /mind/tasks\n\nToon alle taken voor de huidige mind.\n\n```bash\n# Alle taken\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/tasks\n\n# Filter op status\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/mind/tasks?status=pending\"\n```\n\nRespons:\n\n```json\n{\n \"tasks\": [\n {\n \"id\": \"task_001\",\n \"title\": \"Deploy v1.5.0\",\n \"description\": \"Push to production after CI green\",\n \"priority\": \"high\",\n \"status\": \"in_progress\",\n \"due_at\": \"2026-06-28T...\",\n \"created_at\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### POST /mind/task\n\nMaak een nieuwe taak aan.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/mind/task \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"title\": \"Update documentation\",\n \"description\": \"Add v1.5.0 changelog entries\",\n \"priority\": \"normal\",\n \"due_at\": \"2026-06-30T00:00:00Z\"\n }'\n```\n\n### GET /mind/task (queryparams)\n\nMaak een taak aan via GET (voor URL-only tools).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/mind/task?title=Test+task&priority=high\"\n```\n\n### PUT /mind/task/:id\n\nWerk een bestaande taak bij.\n\n```bash\ncurl -X PUT https://synapse.schaefer.zone/mind/task/task_001 \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"status\": \"in_progress\",\n \"description\": \"Currently deploying, CI is green\"\n }'\n```\n\n### GET /mind/task/:id/complete\n\nMarkeer een taak als voltooid.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/task/task_001/complete\n```\n\n### GET /mind/task/:id/delete\n\nVerwijder een taak permanent.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/task/task_001/delete\n```\n\n## Prioriteiten\n\n- `low` — niet urgent\n- `normal` — standaard\n- `high` — belangrijk\n- `critical` — onmiddellijk doen\n\n## Statussen\n\n- `pending` — aangemaakt, niet gestart\n- `in_progress` — wordt momenteel aan gewerkt\n- `done` — voltooid\n- `cancelled` — afgebroken\n\n## Patroon: taakgedreven workflow\n\n```python\n# At session start\ntasks = list_tasks(status=\"in_progress\")\nif tasks:\n print(f\"Resuming: {tasks[0].title}\")\n\n# Plan multi-step work\nfor step in plan:\n task = create_task(title=step)\n\n# Update as you progress\nupdate_task(task.id, status=\"in_progress\")\n# ... do work ...\nupdate_task(task.id, status=\"done\")\n```\n\n## Volgende stappen\n\n- [Task-Driven Workflow](/docs/llm-cookbook/task-driven-workflow)\n- [Cron & Scheduler](/docs/api/cron)\n","content_html":"

Tasks API

\n

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

\n

Eindpunten

\n

GET /mind/tasks

\n

Toon alle taken voor de huidige mind.

\n
# Alle taken\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/mind/tasks\n\n# Filter op status\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/mind/tasks?status=pending"

Respons:

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

POST /mind/task

\n

Maak een nieuwe taak aan.

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

GET /mind/task (queryparams)

\n

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

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

PUT /mind/task/:id

\n

Werk een bestaande taak bij.

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

GET /mind/task/:id/complete

\n

Markeer een taak als voltooid.

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

GET /mind/task/:id/delete

\n

Verwijder een taak permanent.

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

Prioriteiten

\n\n

Statussen

\n\n

Patroon: taakgedreven workflow

\n
# At session start\ntasks = list_tasks(status="in_progress")\nif tasks:\n    print(f"Resuming: {tasks[0].title}")\n\n# Plan multi-step work\nfor step in plan:\n    task = create_task(title=step)\n\n# Update as you progress\nupdate_task(task.id, status="in_progress")\n# ... do work ...\nupdate_task(task.id, status="done")

Volgende stappen

\n\n","urls":{"html":"/docs/api/tasks","text":"/docs/api/tasks?format=text","json":"/docs/api/tasks?format=json","llm":"/docs/api/tasks?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}