{"title":"Tasks API","slug":"tasks","category":"api","summary":"إدارة المهام لوكلاء LLM — إنشاء، قائمة، تحديث، إكمال، حذف المهام بأولويات.","audience":["human","llm"],"tags":["api","tasks","todo","management"],"difficulty":"beginner","updated":"2026-06-27","word_count":139,"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":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# Tasks API\n\nتُعطي Tasks API لوكلاء LLM طريقة منظمة لتتبّع العمل متعدد الخطوات.\nتكون المهام محدودة بالعقل الحالي وتستمر عبر الجلسات، حتى يتمكن الوكيل من\nاستئناف العمل من حيث توقف.\n\n## نقاط النهاية\n\n### GET /mind/tasks\n\nقائمة بجميع المهام للعقل الحالي.\n\n```bash\n# جميع المهام\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/tasks\n\n# تصفية حسب الحالة\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/mind/tasks?status=pending\"\n```\n\nالاستجابة:\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\nإنشاء مهمة جديدة.\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 (معاملات الاستعلام)\n\nإنشاء مهمة عبر GET (للأدوات التي تفتح عناوين URL فقط).\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\nتحديث مهمة موجودة.\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\nتعليم مهمة كمنجزة.\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\nحذف مهمة نهائيًا.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/task/task_001/delete\n```\n\n## الأولويات\n\n- `low` — غير عاجل\n- `normal` — افتراضي\n- `high` — مهم\n- `critical` — يجب فعله فورًا\n\n## الحالات\n\n- `pending` — أُنشئت، لم تبدأ\n- `in_progress` — يجري العمل عليها حاليًا\n- `done` — مكتملة\n- `cancelled` — متروكة\n\n## النمط: سير عمل مدفوع بالمهام\n\n```python\n# عند بدء الجلسة\ntasks = list_tasks(status=\"in_progress\")\nif tasks:\n print(f\"Resuming: {tasks[0].title}\")\n\n# تخطيط العمل متعدد الخطوات\nfor step in plan:\n task = create_task(title=step)\n\n# التحديث أثناء التقدم\nupdate_task(task.id, status=\"in_progress\")\n# ... تنفيذ العمل ...\nupdate_task(task.id, status=\"done\")\n```\n\n## الخطوات التالية\n\n- [سير عمل مدفوع بالمهام](/docs/llm-cookbook/task-driven-workflow)\n- [Cron والمجدول](/docs/api/cron)\n","content_html":"

Tasks API

\n

تُعطي Tasks API لوكلاء LLM طريقة منظمة لتتبّع العمل متعدد الخطوات.\nتكون المهام محدودة بالعقل الحالي وتستمر عبر الجلسات، حتى يتمكن الوكيل من\nاستئناف العمل من حيث توقف.

\n

نقاط النهاية

\n

GET /mind/tasks

\n

قائمة بجميع المهام للعقل الحالي.

\n
# جميع المهام\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/mind/tasks\n\n# تصفية حسب الحالة\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/mind/tasks?status=pending"

الاستجابة:

\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

إنشاء مهمة جديدة.

\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 (معاملات الاستعلام)

\n

إنشاء مهمة عبر GET (للأدوات التي تفتح عناوين URL فقط).

\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

تحديث مهمة موجودة.

\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

تعليم مهمة كمنجزة.

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

GET /mind/task/:id/delete

\n

حذف مهمة نهائيًا.

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

الأولويات

\n\n

الحالات

\n\n

النمط: سير عمل مدفوع بالمهام

\n
# عند بدء الجلسة\ntasks = list_tasks(status="in_progress")\nif tasks:\n    print(f"Resuming: {tasks[0].title}")\n\n# تخطيط العمل متعدد الخطوات\nfor step in plan:\n    task = create_task(title=step)\n\n# التحديث أثناء التقدم\nupdate_task(task.id, status="in_progress")\n# ... تنفيذ العمل ...\nupdate_task(task.id, status="done")

الخطوات التالية

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