Import tasks from CSV

Tasks Copy for LLM View as Markdown

POST/api/project/{projectId}/task/import-csv

Imports tasks from a CSV file into the project and returns the number of rows imported. Send multipart/form-data with the CSV in a part named file (up to 10 MB and 10,000 rows, UTF-8; a BOM is fine). The first row is a header and is skipped. Each row has these 14 columns in this order — the same layout as the CSV export, so you can edit an exported file and import it again: id, name, description, responsibleUser, ballHoldingUser, startDate, dueDate, status, milestone, parent, tags, planned, actual, sortOrder • id: the ID of a task in this project updates that task. Empty or any other value creates a new task (other rows can refer to the value in parent). • name is required. description is Markdown. • responsibleUser, ballHoldingUser: a user name or full name. Names that match no one are ignored. • startDate, dueDate: YYYY-MM-DD. • status, milestone: a status or milestone name in this project. Names that match nothing are left empty. • parent: a parent task ID, or an id value from the same file. Empty makes it a top-level task. • tags: comma-separated tag names. Missing tags are created. • planned, actual, sortOrder: numbers (planned, actual, sort order). When a row updates a task, empty cells clear those fields.