Tasks track work that isn't finished yet, with a status that changes over time. Use them for follow-ups an agent can't do now, blockers, or work pulled in from GitHub and Linear. Importing the same upstream item again updates the existing task rather than duplicating it, so imports are safe to re-run.
{
"id": "bc9260be-ae5f-4c71-9b47-92c557e4d65b",
"title": "Publish thread title capture PR",
"summary": "Implementation ready; blocked on repository access.",
"description": "...",
"status": "blocked",
"assignee_user_id": null,
"tags": ["threads"],
"source": { "type": "agent", "item_type": "task", "item_id": null, "url": null, "repo": "acme/web", "project_key": null, "actor": "Jane Doe", "raw_event": null },
"created_at": "2026-10-25T01:19:47.187+00:00",
"updated_at": "2026-10-25T01:19:47.187+00:00"
}
Responses currently also include internal fields (org_id, project, created_by, origin, embedding). Don't build on them.
Field Values statusopen, triaged, in_progress, blocked count as active (plan limit); resolved, closed, cancelled don'tsource.typemanual, agent, github, linear
Param titleRequired summaryFor GitHub/Linear sources, generated from source.raw_event if omitted descriptionstatusDefault open assignee_user_idUUID; find it with workspace_people_list tagssourcetype (default manual), item_type, item_id, url, repo, project_key, actor, raw_event
Tool Params tasks_recentstatus, source_type, limit 1–100 (default 20)tasks_searchquery required , status, source_type, limit 1–100 (default 10). Semantic, like ccr_search.tasks_getid required
Useful for turning CI failures into tracked work, not just issues and PRs.
Param owner, repoRequired categoryRequired: issues, pull_requests, workflow_failures, deployment_failures, test_failuresstateopen (default), closed, allper_page1–100 (default 20) page1–50
Param categoryRequired: issues, initiativesteam_keyLimit to one Linear team limit1–100 (default 20)