---
title: "Update Task Endpoint"
method: PATCH
path: "/api/projects/{project_id}/tasks/{task_id}"
tags: ["task_dag_mutations"]
---

# Update Task Endpoint

`PATCH /api/projects/{project_id}/tasks/{task_id}`

## Path parameters

- `project_id` string, required
- `task_id` string, required

## Request body

- UpdateTaskRequest
  - `chat_session_id` string, required — Chat session ID of the caller (must be assignee or creator)
  - `new_status` string, nullable — New status: in_progress, completed, failed, or cancelled. Omit to update fields only.
  - `new_title` string, nullable — Update the task title (planned tasks only)
  - `new_objective` string, nullable — Update the task objective (planned tasks only)
  - `notes` string, nullable — Append a note to the task
  - `add_blocked_by` string[], nullable — Add upstream dependencies (task IDs)
  - `remove_blocked_by` string[], nullable — Remove upstream dependencies (planned tasks only)
  - `add_blocking` string[], nullable — Add downstream dependencies (task IDs)
  - `remove_blocking` string[], nullable — Remove downstream dependencies (planned tasks only)
  - `add_required_variables` AddRequiredVariableRequest[], nullable — Add required variables (planned tasks only)
    - `name` string, required — Variable name
    - `type` string — Expected type: float, int, str, bool, list[float], list[int], list[str], or any
    - `description` string, nullable — Optional human-readable description of the variable
  - `remove_required_variables` string[], nullable — Remove required variables by name (planned tasks only)
  - `remove_starter_cells` string[], nullable — Remove starter cells by cell ID (planned tasks only)

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quadrillion/quadrillion-cloud-api/versions/399077308c86/schema)