[{"_1":2,"_441":-5,"_442":-5},"loaderData",{"_3":4,"_38":39},"root",{"_5":6,"_17":-5,"_18":19,"_20":21,"_22":23},"requestInfo",{"_7":8,"_13":14,"_15":16},"hints",{"_9":10,"_11":12},"theme","light","timeZone","UTC","origin","https://plot.app","path","/docs/tasks","user","csrfToken","Nht##vl!64Y1$Z+NkYM(zyqkz0nlnog*","honeyProps",["P",21],"ENV",{"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":35,"_36":37},"BACKEND_URL","https://api.plot.app","NODE_ENV","production","FRONTEND_URL","https://go.plot.app","REDDIT_PIXEL_ID","a2_hrf906c8duhm","TIKTOK_PIXEL_ID","D6JH82JC77U93QMLV630","POSTHOG_KEY","phc_1jkCnlZdi9Gdc2eYswwVhsXqWhDScweWQQjWXnPWrUF","POSTHOG_HOST","https://eu.i.posthog.com","routes/docs+/$",{"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_56":57},"type","docs","title","Tasks","description","Track the specific work your team needs to complete.","body","var Component=(()=>{var h=Object.create;var r=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,f=Object.prototype.hasOwnProperty;var w=(e,n)=>()=>(n||e((n={exports:{}}).exports,n),n.exports),_=(e,n)=>{for(var o in n)r(e,o,{get:n[o],enumerable:!0})},a=(e,n,o,i)=>{if(n&&typeof n==\"object\"||typeof n==\"function\")for(let s of u(n))!f.call(e,s)&&s!==o&&r(e,s,{get:()=>n[s],enumerable:!(i=p(n,s))||i.enumerable});return e};var j=(e,n,o)=>(o=e!=null?h(x(e)):{},a(n||!e||!e.__esModule?r(o,\"default\",{value:e,enumerable:!0}):o,e)),v=e=>a(r({},\"__esModule\",{value:!0}),e);var l=w((g,c)=>{c.exports=_jsx_runtime});var k={};_(k,{default:()=>d});var t=j(l());function m(e){let n={h2:\"h2\",p:\"p\",...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.p,{children:\"Tasks are the smallest unit of planned work in Plot.\"}),`\n`,(0,t.jsx)(n.h2,{id:\"overview\",children:\"Overview\"}),`\n`,(0,t.jsx)(n.p,{children:\"Use tasks for implementation work, follow-ups, decisions, and review items.\"})]})}function d(e={}){let{wrapper:n}=e.components||{};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(m,{...e})}):m(e)}return v(k);})();\n;return Component;","toc",[50],{"_42":51,"_52":53,"_54":55},"Overview","url","#overview","depth",2,"pageTree",{"_58":59,"_60":61},"$fumadocs_loader","page-tree","data",{"_40":3,"_62":63,"_68":3,"_69":70,"_44":-7,"_71":72,"_407":408},"$ref",{"_64":65,"_66":67},"folder","","meta","meta.json","$id","name","App Docs","children",[73,175],{"_40":64,"_69":74,"_3":75,"_76":75,"_44":77,"_78":-7,"_71":79,"_68":172,"_62":173,"_83":-7},"Plot CLI",true,"defaultOpen","Use Plot from your terminal or AI agent.","collapsible",[80,85,89,94,99,102,167],{"_68":81,"_40":82,"_83":-7,"_69":84},"_0","separator","icon","Introduction",{"_68":86,"_40":87,"_69":51,"_44":77,"_83":-7,"_52":88,"_62":86},"cli/index.md","page","/docs/cli",{"_68":90,"_40":87,"_69":91,"_44":92,"_83":-7,"_52":93,"_62":90},"cli/getting-started.mdx","Installation","Install the Plot CLI and connect it to your workspace.","/docs/cli/getting-started",{"_68":95,"_40":87,"_69":96,"_44":97,"_83":-7,"_52":98,"_62":95},"cli/configuration.md","Configuration","Configure Plot CLI credentials, output, local files, and updates.","/docs/cli/configuration",{"_68":100,"_40":82,"_83":-7,"_69":101},"_1","Reference",{"_40":64,"_69":103,"_3":-7,"_76":75,"_44":104,"_78":-7,"_71":105,"_68":160,"_62":161,"_163":164,"_83":-7},"Commands","Commands available in the Plot CLI.",[106,111,116,120,125,130,135,140,145,150,155],{"_68":107,"_40":87,"_69":108,"_44":109,"_83":-7,"_52":110,"_62":107},"cli/commands/auth.md","Authentication","Sign in, inspect the active user, and remove credentials.","/docs/cli/commands/auth",{"_68":112,"_40":87,"_69":113,"_44":114,"_83":-7,"_52":115,"_62":112},"cli/commands/workspaces.md","Workspaces","List workspaces, switch the active workspace, and fetch orientation data.","/docs/cli/commands/workspaces",{"_68":117,"_40":87,"_69":43,"_44":118,"_83":-7,"_52":119,"_62":117},"cli/commands/tasks.md","Read, create, update, organize, and delete tasks.","/docs/cli/commands/tasks",{"_68":121,"_40":87,"_69":122,"_44":123,"_83":-7,"_52":124,"_62":121},"cli/commands/projects.md","Projects","List projects, inspect project details, summarize health, and update fields.","/docs/cli/commands/projects",{"_68":126,"_40":87,"_69":127,"_44":128,"_83":-7,"_52":129,"_62":126},"cli/commands/documents.md","Documents","List, read, create, and update Plot documents.","/docs/cli/commands/documents",{"_68":131,"_40":87,"_69":132,"_44":133,"_83":-7,"_52":134,"_62":131},"cli/commands/collections.md","Collections","List, inspect, create, and update collections.","/docs/cli/commands/collections",{"_68":136,"_40":87,"_69":137,"_44":138,"_83":-7,"_52":139,"_62":136},"cli/commands/teams-users.md","Teams And Users","Discover teams, statuses, labels, and workspace members.","/docs/cli/commands/teams-users",{"_68":141,"_40":87,"_69":142,"_44":143,"_83":-7,"_52":144,"_62":141},"cli/commands/comments-activity-inbox.md","Comments, Activity, And Inbox","Read discussions, leave updates, inspect activity, and manage notifications.","/docs/cli/commands/comments-activity-inbox",{"_68":146,"_40":87,"_69":147,"_44":148,"_83":-7,"_52":149,"_62":146},"cli/commands/search.md","Search","Search tasks, projects, documents, teams, users, comments, and workspace context.","/docs/cli/commands/search",{"_68":151,"_40":87,"_69":152,"_44":153,"_83":-7,"_52":154,"_62":151},"cli/commands/batch.md","Batch","Run several CLI operations from one JSON payload.","/docs/cli/commands/batch",{"_68":156,"_40":87,"_69":157,"_44":158,"_83":-7,"_52":159,"_62":156},"cli/commands/maintenance.md","Maintenance","Update, repair, configure, and set up the CLI.","/docs/cli/commands/maintenance","cli/commands",{"_64":160,"_66":162},"cli/commands/meta.json","index",{"_68":165,"_40":87,"_69":103,"_44":104,"_83":-7,"_52":166,"_62":165},"cli/commands/index.md","/docs/cli/commands",{"_68":168,"_40":87,"_69":169,"_44":170,"_83":-7,"_52":171,"_62":168},"cli/agentic-usage.md","Agentic Usage","Let AI agents use Plot as shared workspace context.","/docs/cli/agentic-usage","cli",{"_64":172,"_66":174},"cli/meta.json",{"_40":64,"_69":176,"_3":75,"_76":75,"_44":177,"_78":-7,"_71":178,"_68":404,"_62":405,"_83":-7,"_163":406},"API Reference","HTTP API endpoints for Plot.",[179,193,227,242,286,350,365,375,395],{"_40":64,"_69":132,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":180,"_68":191,"_62":192,"_83":-7},[181,186],{"_68":182,"_40":87,"_69":183,"_44":184,"_83":-7,"_52":185,"_62":182},"api/collections/list-get.mdx","List Collections GET","Retrieves a paginated list of collections in the workspace","/docs/api/collections/list-get",{"_68":187,"_40":87,"_69":188,"_44":189,"_83":-7,"_52":190,"_62":187},"api/collections/post.mdx","Create or Update Collection POST","Creates a new collection or updates an existing one if ID is provided","/docs/api/collections/post","api/collections",{"_64":191,"_66":-7},{"_40":64,"_69":127,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":194,"_68":225,"_62":226,"_83":-7},[195,200,205,210,215,220],{"_68":196,"_40":87,"_69":197,"_44":198,"_83":-7,"_52":199,"_62":196},"api/documents/id-delete.mdx","Delete Document DELETE","Soft-deletes a document by ID","/docs/api/documents/id-delete",{"_68":201,"_40":87,"_69":202,"_44":203,"_83":-7,"_52":204,"_62":201},"api/documents/id-get.mdx","Get Document GET","Retrieves a single document by ID","/docs/api/documents/id-get",{"_68":206,"_40":87,"_69":207,"_44":208,"_83":-7,"_52":209,"_62":206},"api/documents/id-restore-post.mdx","Restore Document POST","Restores a previously soft-deleted document","/docs/api/documents/id-restore-post",{"_68":211,"_40":87,"_69":212,"_44":213,"_83":-7,"_52":214,"_62":211},"api/documents/list-get.mdx","List Documents GET","Retrieves a paginated list of documents for a team","/docs/api/documents/list-get",{"_68":216,"_40":87,"_69":217,"_44":218,"_83":-7,"_52":219,"_62":216},"api/documents/post.mdx","Create or Update Document POST","Creates a new document or updates an existing one if ID is provided","/docs/api/documents/post",{"_68":221,"_40":87,"_69":222,"_44":223,"_83":-7,"_52":224,"_62":221},"api/documents/search-get.mdx","Search Documents GET","Searches documents by name, description, or team name using full-text search","/docs/api/documents/search-get","api/documents",{"_64":225,"_66":-7},{"_40":64,"_69":228,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":229,"_68":240,"_62":241,"_83":-7},"Posts",[230,235],{"_68":231,"_40":87,"_69":232,"_44":233,"_83":-7,"_52":234,"_62":231},"api/posts/list-get.mdx","List Posts GET","Retrieves a paginated list of posts for a specific entity. Excludes replies (only returns top-level posts).","/docs/api/posts/list-get",{"_68":236,"_40":87,"_69":237,"_44":238,"_83":-7,"_52":239,"_62":236},"api/posts/post.mdx","Create Post POST","Creates a new post on the specified entity","/docs/api/posts/post","api/posts",{"_64":240,"_66":-7},{"_40":64,"_69":122,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":243,"_68":284,"_62":285,"_83":-7},[244,249,254,259,264,269,274,279],{"_68":245,"_40":87,"_69":246,"_44":247,"_83":-7,"_52":248,"_62":245},"api/projects/id-archive-post.mdx","Archive Project POST","Archives a project by ID","/docs/api/projects/id-archive-post",{"_68":250,"_40":87,"_69":251,"_44":252,"_83":-7,"_52":253,"_62":250},"api/projects/id-get.mdx","Get Project GET","Retrieves a single project by ID","/docs/api/projects/id-get",{"_68":255,"_40":87,"_69":256,"_44":257,"_83":-7,"_52":258,"_62":255},"api/projects/id-status-update-post.mdx","Post Status Update POST","Updates the project status and creates a status update post with the provided content","/docs/api/projects/id-status-update-post",{"_68":260,"_40":87,"_69":261,"_44":262,"_83":-7,"_52":263,"_62":260},"api/projects/id-unarchive-post.mdx","Unarchive Project POST","Unarchives a previously archived project","/docs/api/projects/id-unarchive-post",{"_68":265,"_40":87,"_69":266,"_44":267,"_83":-7,"_52":268,"_62":265},"api/projects/list-get.mdx","List Projects GET","Retrieves a paginated list of projects with optional filters","/docs/api/projects/list-get",{"_68":270,"_40":87,"_69":271,"_44":272,"_83":-7,"_52":273,"_62":270},"api/projects/post.mdx","Create or Update Project POST","Creates a new project or updates an existing one if ID is provided","/docs/api/projects/post",{"_68":275,"_40":87,"_69":276,"_44":277,"_83":-7,"_52":278,"_62":275},"api/projects/search-get.mdx","Search Projects GET","Searches projects by name, description, owner name, or team name using full-text search","/docs/api/projects/search-get",{"_68":280,"_40":87,"_69":281,"_44":282,"_83":-7,"_52":283,"_62":280},"api/projects/statuses-get.mdx","List Project Statuses GET","Retrieves all project statuses for the workspace","/docs/api/projects/statuses-get","api/projects",{"_64":284,"_66":-7},{"_40":64,"_69":43,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":287,"_68":348,"_62":349,"_83":-7},[288,293,298,303,308,313,318,323,328,333,338,343],{"_68":289,"_40":87,"_69":290,"_44":291,"_83":-7,"_52":292,"_62":289},"api/tasks/batch-post.mdx","Batch Create or Update Tasks POST","Creates or updates multiple tasks in a single request (max 100)","/docs/api/tasks/batch-post",{"_68":294,"_40":87,"_69":295,"_44":296,"_83":-7,"_52":297,"_62":294},"api/tasks/id-delete.mdx","Delete Task DELETE","Soft-deletes a task by ID","/docs/api/tasks/id-delete",{"_68":299,"_40":87,"_69":300,"_44":301,"_83":-7,"_52":302,"_62":299},"api/tasks/id-get.mdx","Get Task GET","Retrieves a single task by ID","/docs/api/tasks/id-get",{"_68":304,"_40":87,"_69":305,"_44":306,"_83":-7,"_52":307,"_62":304},"api/tasks/id-restore-post.mdx","Restore Task POST","Restores a previously soft-deleted task","/docs/api/tasks/id-restore-post",{"_68":309,"_40":87,"_69":310,"_44":311,"_83":-7,"_52":312,"_62":309},"api/tasks/labels-get.mdx","List Task Labels GET","Retrieves all task labels for a team","/docs/api/tasks/labels-get",{"_68":314,"_40":87,"_69":315,"_44":316,"_83":-7,"_52":317,"_62":314},"api/tasks/labels-post.mdx","Create Task Label POST","Creates a new task label for a team","/docs/api/tasks/labels-post",{"_68":319,"_40":87,"_69":320,"_44":321,"_83":-7,"_52":322,"_62":319},"api/tasks/list-get.mdx","List Tasks GET","Retrieves a paginated list of tasks with optional filters","/docs/api/tasks/list-get",{"_68":324,"_40":87,"_69":325,"_44":326,"_83":-7,"_52":327,"_62":324},"api/tasks/post.mdx","Create or Update Task POST","Creates a new task or updates an existing one if ID is provided","/docs/api/tasks/post",{"_68":329,"_40":87,"_69":330,"_44":331,"_83":-7,"_52":332,"_62":329},"api/tasks/search-get.mdx","Search Tasks GET","Searches tasks by name, description, project name, team name, or assignee name using full-text search","/docs/api/tasks/search-get",{"_68":334,"_40":87,"_69":335,"_44":336,"_83":-7,"_52":337,"_62":334},"api/tasks/statuses-get.mdx","List Task Statuses GET","Retrieves all task statuses for a team","/docs/api/tasks/statuses-get",{"_68":339,"_40":87,"_69":340,"_44":341,"_83":-7,"_52":342,"_62":339},"api/tasks/taskId-labels-labelId-delete.mdx","Remove Label from Task DELETE","Removes a label from a task. Idempotent - removing a non-attached label is a no-op.","/docs/api/tasks/taskId-labels-labelId-delete",{"_68":344,"_40":87,"_69":345,"_44":346,"_83":-7,"_52":347,"_62":344},"api/tasks/taskId-labels-labelId-post.mdx","Add Label to Task POST","Adds a label to a task. Idempotent - adding an existing label is a no-op.","/docs/api/tasks/taskId-labels-labelId-post","api/tasks",{"_64":348,"_66":-7},{"_40":64,"_69":351,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":352,"_68":363,"_62":364,"_83":-7},"Teams",[353,358],{"_68":354,"_40":87,"_69":355,"_44":356,"_83":-7,"_52":357,"_62":354},"api/teams/list-get.mdx","List Teams GET","Retrieves a paginated list of visible teams in the workspace (non-private teams, plus private teams the user is a member of).","/docs/api/teams/list-get",{"_68":359,"_40":87,"_69":360,"_44":361,"_83":-7,"_52":362,"_62":359},"api/teams/search-get.mdx","Search Teams GET","Searches teams by name using full-text search","/docs/api/teams/search-get","api/teams",{"_64":363,"_66":-7},{"_40":64,"_69":366,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":367,"_68":373,"_62":374,"_83":-7},"Ui",[368],{"_68":369,"_40":87,"_69":370,"_44":371,"_83":-7,"_52":372,"_62":369},"api/ui/colors-get.mdx","List UI Colors GET","Returns available UI color tokens for dropdowns.","/docs/api/ui/colors-get","api/ui",{"_64":373,"_66":-7},{"_40":64,"_69":376,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":377,"_68":393,"_62":394,"_83":-7},"Webhooks",[378,383,388],{"_68":379,"_40":87,"_69":380,"_44":381,"_83":-7,"_52":382,"_62":379},"api/webhooks/subscribe-get.mdx","List Webhook Subscriptions GET","Lists all webhook subscriptions for the authenticated user","/docs/api/webhooks/subscribe-get",{"_68":384,"_40":87,"_69":385,"_44":386,"_83":-7,"_52":387,"_62":384},"api/webhooks/subscribe-id-delete.mdx","Unsubscribe from Webhook Events DELETE","Removes a webhook subscription by ID","/docs/api/webhooks/subscribe-id-delete",{"_68":389,"_40":87,"_69":390,"_44":391,"_83":-7,"_52":392,"_62":389},"api/webhooks/subscribe-post.mdx","Subscribe to Webhook Events POST","Creates a webhook subscription for the specified event type. The hookUrl will receive POST requests when events occur.","/docs/api/webhooks/subscribe-post","api/webhooks",{"_64":393,"_66":-7},{"_40":64,"_69":113,"_3":-7,"_76":-7,"_44":-7,"_78":-7,"_71":396,"_68":402,"_62":403,"_83":-7},[397],{"_68":398,"_40":87,"_69":399,"_44":400,"_83":-7,"_52":401,"_62":398},"api/workspaces/members-list-get.mdx","List Workspace Members GET","Retrieves a paginated list of workspace members.","/docs/api/workspaces/members-list-get","api/workspaces",{"_64":402,"_66":-7},"api",{"_64":404,"_66":-7},{"_68":182,"_40":87,"_69":183,"_44":184,"_83":-7,"_52":185,"_62":182},"fallback",{"_40":3,"_62":409,"_68":410,"_69":411,"_44":-7,"_71":412},{"_64":65,"_66":-7},"fallback:root","Docs",[413],{"_40":64,"_69":414,"_3":75,"_76":75,"_44":415,"_78":-7,"_71":416,"_68":437,"_62":438,"_83":-7},"Guides","Learn the core Plot workflows.",[417,423,429,434],{"_68":418,"_40":87,"_69":419,"_44":420,"_83":-7,"_52":421,"_62":422},"fallback:(guides)/index.md","Plot Docs","Learn how to use Plot.","/docs","(guides)/index.md",{"_68":424,"_40":87,"_69":425,"_44":426,"_83":-7,"_52":427,"_62":428},"fallback:(guides)/example.md","Example","A placeholder page for testing the docs pipeline.","/docs/example","(guides)/example.md",{"_68":430,"_40":87,"_69":122,"_44":431,"_83":-7,"_52":432,"_62":433},"fallback:(guides)/projects.md","Plan and track work across your team.","/docs/projects","(guides)/projects.md",{"_68":435,"_40":87,"_69":43,"_44":45,"_83":-7,"_52":16,"_62":436},"fallback:(guides)/tasks.md","(guides)/tasks.md","fallback:(guides)",{"_64":439,"_66":440},"(guides)","(guides)/meta.json","actionData","errors"]

Tasks

Overview

On this page