{"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":162,"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":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# Tasks API\n\nTasks API LLM एजेंट्स को बहु-चरणीय कार्य को ट्रैक करने का एक संरचित तरीका देता है। कार्य वर्तमान mind तक सीमित हैं और सत्रों में बने रहते हैं, इसलिए एजेंट जहाँ छोड़ा था वहाँ से काम फिर से शुरू कर सकता है।\n\n## एंडपॉइंट्स\n\n### GET /mind/tasks\n\nवर्तमान mind के लिए सभी कार्यों की सूची बनाएँ।\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\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\nGET के माध्यम से कार्य बनाएँ (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# 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## अगले कदम\n\n- [कार्य-चालित वर्कफ़्लो](/docs/llm-cookbook/task-driven-workflow)\n- [Cron और Scheduler](/docs/api/cron)\n","content_html":"<h1>Tasks API</h1>\n<p>Tasks API LLM एजेंट्स को बहु-चरणीय कार्य को ट्रैक करने का एक संरचित तरीका देता है। कार्य वर्तमान mind तक सीमित हैं और सत्रों में बने रहते हैं, इसलिए एजेंट जहाँ छोड़ा था वहाँ से काम फिर से शुरू कर सकता है।</p>\n<h2>एंडपॉइंट्स</h2>\n<h3>GET /mind/tasks</h3>\n<p>वर्तमान mind के लिए सभी कार्यों की सूची बनाएँ।</p>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># All tasks</span>\ncurl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/mind/tasks\n\n<span class=\"hljs-comment\"># Filter by status</span>\ncurl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone/mind/tasks?status=pending&quot;</span></code></pre><p>प्रतिक्रिया:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;tasks&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span>\n    <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;id&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;task_001&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;title&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;Deploy v1.5.0&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;description&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;Push to production after CI green&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;priority&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;high&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;status&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;in_progress&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;due_at&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;2026-06-28T...&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;created_at&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;2026-06-27T...&quot;</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">]</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><h3>POST /mind/task</h3>\n<p>नया कार्य बनाएँ।</p>\n<pre><code class=\"hljs language-bash\">curl -X POST https://synapse.schaefer.zone/mind/task \\\n  -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n  -H <span class=\"hljs-string\">&quot;Content-Type: application/json&quot;</span> \\\n  -d <span class=\"hljs-string\">&#x27;{\n    &quot;title&quot;: &quot;Update documentation&quot;,\n    &quot;description&quot;: &quot;Add v1.5.0 changelog entries&quot;,\n    &quot;priority&quot;: &quot;normal&quot;,\n    &quot;due_at&quot;: &quot;2026-06-30T00:00:00Z&quot;\n  }&#x27;</span></code></pre><h3>GET /mind/task (क्वेरी पैरामीटर्स)</h3>\n<p>GET के माध्यम से कार्य बनाएँ (URL-केवल टूल्स के लिए)।</p>\n<pre><code class=\"hljs language-bash\">curl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone/mind/task?title=Test+task&amp;priority=high&quot;</span></code></pre><h3>PUT /mind/task/:id</h3>\n<p>मौजूदा कार्य अपडेट करें।</p>\n<pre><code class=\"hljs language-bash\">curl -X PUT https://synapse.schaefer.zone/mind/task/task_001 \\\n  -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n  -H <span class=\"hljs-string\">&quot;Content-Type: application/json&quot;</span> \\\n  -d <span class=\"hljs-string\">&#x27;{\n    &quot;status&quot;: &quot;in_progress&quot;,\n    &quot;description&quot;: &quot;Currently deploying, CI is green&quot;\n  }&#x27;</span></code></pre><h3>GET /mind/task/:id/complete</h3>\n<p>कार्य को पूर्ण चिह्नित करें।</p>\n<pre><code class=\"hljs language-bash\">curl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/mind/task/task_001/complete</code></pre><h3>GET /mind/task/:id/delete</h3>\n<p>कार्य को स्थायी रूप से हटाएँ।</p>\n<pre><code class=\"hljs language-bash\">curl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/mind/task/task_001/delete</code></pre><h2>प्राथमिकताएँ</h2>\n<ul>\n<li><code>low</code> — गैर-तात्कालिक</li>\n<li><code>normal</code> — डिफ़ॉल्ट</li>\n<li><code>high</code> — महत्वपूर्ण</li>\n<li><code>critical</code> — तुरंत करना चाहिए</li>\n</ul>\n<h2>स्थितियाँ</h2>\n<ul>\n<li><code>pending</code> — बनाया गया, शुरू नहीं हुआ</li>\n<li><code>in_progress</code> — वर्तमान में कार्य चल रहा है</li>\n<li><code>done</code> — पूर्ण</li>\n<li><code>cancelled</code> — परित्यक्त</li>\n</ul>\n<h2>पैटर्न: कार्य-चालित वर्कफ़्लो</h2>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-comment\"># At session start</span>\ntasks = list_tasks(status=<span class=\"hljs-string\">&quot;in_progress&quot;</span>)\n<span class=\"hljs-keyword\">if</span> tasks:\n    <span class=\"hljs-built_in\">print</span>(<span class=\"hljs-string\">f&quot;Resuming: <span class=\"hljs-subst\">{tasks[<span class=\"hljs-number\">0</span>].title}</span>&quot;</span>)\n\n<span class=\"hljs-comment\"># Plan multi-step work</span>\n<span class=\"hljs-keyword\">for</span> step <span class=\"hljs-keyword\">in</span> plan:\n    task = create_task(title=step)\n\n<span class=\"hljs-comment\"># Update as you progress</span>\nupdate_task(task.<span class=\"hljs-built_in\">id</span>, status=<span class=\"hljs-string\">&quot;in_progress&quot;</span>)\n<span class=\"hljs-comment\"># ... do work ...</span>\nupdate_task(task.<span class=\"hljs-built_in\">id</span>, status=<span class=\"hljs-string\">&quot;done&quot;</span>)</code></pre><h2>अगले कदम</h2>\n<ul>\n<li><a href=\"/docs/llm-cookbook/task-driven-workflow\">कार्य-चालित वर्कफ़्लो</a></li>\n<li><a href=\"/docs/api/cron\">Cron और Scheduler</a></li>\n</ul>\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"]}