Method moveTask

src/api/TaskNotesAPI.ts:2015–2061

(
		path: string,
		targetFolder: string,
		context?: TaskNotesMutationContext
	)

	}

	async moveTask(
		path: string,
		targetFolder: string,
		context?: TaskNotesMutationContext
	): Promise<TaskInfo> {
		const task = await this.requireTask(path);
		const file = this.requireTaskFile(task.path);
		const normalizedFolder = normalizePath(targetFolder);
		const newPath = normalizedFolder ? `${normalizedFolder}/${file.name}` : file.name;

		if (newPath === task.path) {
			return copyTaskInfo(task);
		}

		return this.withMutationContext([task.path, newPath], context, async () => {
			if (normalizedFolder) {
				await ensureFolderExists(this.plugin.app.vault, normalizedFolder);
			}

			const existingFile = this.plugin.app.vault.getAbstractFileByPath(newPath);
			if (existingFile) {
				throw new TaskNotesApiError(
					"file_already_exists",
					`Cannot move task to "${newPath}" because a file already exists`,
					{ status: 409, details: { path: newPath } }
				);
			}

			await this.plugin.app.fileManager.renameFile(file, newPath);

			const updatedTask = copyTaskInfo({
				...task,
				id: task.id && task.id !== task.path ? task.id : newPath,
				path: newPath,
			});

			this.plugin.cacheManager.clearCacheEntry(task.path);
			this.plugin.cacheManager.updateTaskInfoInCache(newPath, updatedTask);
			this.plugin.emitter.trigger(EVENT_TASK_UPDATED, {
				path: newPath,
				originalTask: task,
				updatedTask,
			});

			return updatedTask;
		});
	}

	async deleteTask(path: string, context?: TaskNotesMutationContext): Promise<void> {
		const task = await this.requireTask(path);