---
title: "Update a task"
method: PATCH
path: "/tasks/{id}"
tags: ["Tasks"]
---

# Update a task

`PATCH /tasks/{id}`

## Request

- Base URL: `https://api.heffl.com/api/v1`
- URL: `https://api.heffl.com/api/v1/tasks/{id}`
- Auth: API key in header `x-api-key`

Updates an existing task. Only provided fields will be updated.

## Path parameters

- `id` string, required: Task public ID

## Request body

- object
  - `title` string: Task title
  - `description` string: Task description
  - `status` 'OPEN' | 'IN_PROGRESS' | 'ON_HOLD' | 'COMPLETED' | 'CANCELLED': Task status
  - `priority` 'LOW' | 'MEDIUM' | 'HIGH': Task priority
  - `dueDate` string, date-time: Due date
  - `startDate` string, date-time: Start date

## Response `200`

OK

- object
  - `id` string, required: Task public ID
  - `number` string, required: Auto-generated task number
  - `title` string, required: Task title
  - `description` string, nullable: Task description
  - `status` string, required: Task status
  - `type` string, required: Task type
  - `priority` string, nullable: Task priority
  - `dueDate` string, date-time, nullable: Due date
  - `startDate` string, date-time, nullable: Start date
  - `createdAt` string, date-time, required: When the task was created

---

[API](https://skmtc.dev/heffl/apis/heffl-public-api-legacy-v1.md) · [All operations](https://skmtc.dev/heffl/apis/heffl-public-api-legacy-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/heffl/apis/heffl-public-api-legacy-v1/revisions/9bdb229223a2?raw)