update-task-backlog
Move tasks to your backlog for later review and organization. This tool helps you defer tasks by transferring them from your active list to the backlog using the task ID.
Instructions
Move a task to the backlog
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limitResponsePayload | No | Whether to limit the response payload size | |
| taskId | Yes | The ID of the task to move to backlog | |
| timezone | No | Timezone string (e.g., 'America/New_York'). If not provided, uses user's default timezone |
Implementation Reference
- src/tools/task-tools.ts:237-264 (handler)Main handler implementation for the 'update-task-backlog' tool. It moves a task to the backlog by calling `updateTaskSnoozeDate` with a null date.
export const updateTaskBacklogTool = withTransportClient({ name: "update-task-backlog", description: "Move a task to the backlog", parameters: updateTaskBacklogSchema, execute: async ( { taskId, timezone, limitResponsePayload }: UpdateTaskBacklogInput, context: ToolContext, ) => { const options: { timezone?: string; limitResponsePayload?: boolean } = {}; if (timezone) options.timezone = timezone; if (limitResponsePayload !== undefined) { options.limitResponsePayload = limitResponsePayload; } const result = await context.client.updateTaskSnoozeDate( taskId, null, options, ); return formatJsonResponse({ success: result.success, taskId, movedToBacklog: true, updatedFields: result.updatedFields, }); }, }); - src/schemas.ts:177-188 (schema)Zod schema defining the input parameters for the 'update-task-backlog' tool.
// Update task backlog parameters export const updateTaskBacklogSchema = z.object({ taskId: z.string().min(1, "Task ID is required").describe( "The ID of the task to move to backlog", ), timezone: z.string().optional().describe( "Timezone string (e.g., 'America/New_York'). If not provided, uses user's default timezone", ), limitResponsePayload: z.boolean().optional().describe( "Whether to limit the response payload size", ), }); - src/tools/task-tools.ts:406-426 (registration)The 'updateTaskBacklogTool' is registered in the taskTools array, which is re-exported from src/tools/index.ts into allTools.
export const taskTools = [ // Query tools getTasksBacklogTool, getTasksByDayTool, getArchivedTasksTool, getTaskByIdTool, // Lifecycle tools createTaskTool, deleteTaskTool, // Update tools updateTaskCompleteTool, updateTaskSnoozeDateTool, updateTaskBacklogTool, updateTaskPlannedTimeTool, updateTaskNotesTool, updateTaskDueDateTool, updateTaskTextTool, updateTaskStreamTool, ]; - src/tools/index.ts:5-9 (registration)Top-level registration where taskTools (containing update-task-backlog) is spread into allTools.
export const allTools = [ ...userTools, ...taskTools, ...streamTools, ]; - src/tools/task-tools.ts:34-40 (helper)Imports helper functions like withTransportClient used to wrap the execute handler.
import { formatJsonResponse, formatPaginatedTsvResponse, formatTsvResponse, withTransportClient, type ToolContext, } from "./shared.js";