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.

# 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:

{
  "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.

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).

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.

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.

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.

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

# 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
• Cron & Scheduler