{"title":"Tasks API","slug":"tasks","category":"api","summary":"LLM ajanları için görev yönetimi — önceliklerle görev oluşturma, listeleme, güncelleme, tamamlama, silme.","audience":["human","llm"],"tags":["api","tasks","todo","management"],"difficulty":"beginner","updated":"2026-06-27","word_count":145,"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":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Tasks API\n\nTasks API, LLM ajanlarına çok adımlı işleri izlemek için yapılandırılmış bir yol sağlar. Görevler mevcut mind'e bağlıdır ve oturumlar arasında kalıcıdır, böylece ajan kaldığı yerden devam edebilir.\n\n## Uç Noktalar\n\n### GET /mind/tasks\n\nMevcut mind için tüm görevleri listele.\n\n```bash\n# All tasks\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/tasks\n\n# Filter by status\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/mind/tasks?status=pending\"\n```\n\nYanıt:\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\nYeni bir görev oluştur.\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 (sorgu parametreleri)\n\nGET ile bir görev oluştur (yalnızca URL kullanan araçlar için).\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\nMevcut bir görevi güncelle.\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\nBir görevi tamamlandı olarak işaretle.\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\nBir görevi kalıcı olarak sil.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/task/task_001/delete\n```\n\n## Öncelikler\n\n- `low` — acil değil\n- `normal` — varsayılan\n- `high` — önemli\n- `critical` — hemen yapılmalı\n\n## Durumlar\n\n- `pending` — oluşturuldu, başlanmadı\n- `in_progress` — şu anda üzerinde çalışılıyor\n- `done` — tamamlandı\n- `cancelled` — terk edildi\n\n## Desen: Görev Odaklı İş Akışı\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## Sonraki Adımlar\n\n- [Görev Odaklı İş Akışı](/docs/llm-cookbook/task-driven-workflow)\n- [Cron & Zamanlayıcı](/docs/api/cron)\n","content_html":"

Tasks API

\n

Tasks API, LLM ajanlarına çok adımlı işleri izlemek için yapılandırılmış bir yol sağlar. Görevler mevcut mind'e bağlıdır ve oturumlar arasında kalıcıdır, böylece ajan kaldığı yerden devam edebilir.

\n

Uç Noktalar

\n

GET /mind/tasks

\n

Mevcut mind için tüm görevleri listele.

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

Yanıt:

\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

Yeni bir görev oluştur.

\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 (sorgu parametreleri)

\n

GET ile bir görev oluştur (yalnızca URL kullanan araçlar için).

\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

Mevcut bir görevi güncelle.

\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

Bir görevi tamamlandı olarak işaretle.

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

GET /mind/task/:id/delete

\n

Bir görevi kalıcı olarak sil.

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

Öncelikler

\n\n

Durumlar

\n\n

Desen: Görev Odaklı İş Akışı

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

Sonraki Adımlar

\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"]}