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

# Update Task Endpoint

`PATCH /api/workspaces/{workspace_id}/tasks/{task_id}`

## Path parameters

- `workspace_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

## Changes

- **2026-08-19** `bc8a81bf3914` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/changes/api/workspaces/:workspace_id/tasks/:task_id/patch.md)

---

[API](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quadrillion/quadrillion-cloud-api/revisions/f4de1bab5efb/schema)