---
title: "Update Task"
method: PUT
path: "/tasks/{task_id}"
tags: ["tasks"]
---

# Update Task

`PUT /tasks/{task_id}`

Update a task (user-facing fields).

## Path parameters

- `task_id` string, uuid, required

## Request body

- UpdateTaskRequest
  - `title` string, nullable
  - `description` string, nullable
  - `priority` string, nullable
  - `status` string, nullable

## Response `200`

Successful Response

- TaskResponse
  - `id` string, required
  - `company_id` string, required
  - `title` string, required
  - `description` string, nullable
  - `status` 'pending' | 'dispatched' | 'in_progress' | 'completed' | 'failed' | 'moderated', required
  - `priority` 'critical' | 'high' | 'normal' | 'low', required
  - `created_by` 'user' | 'ceo_agent' | 'worker_agent' | 'agent', required
  - `runner` string
  - `assigned_to` string, nullable
  - `result_summary` string, nullable
  - `error_message` string, nullable
  - `retry_count` integer, required
  - `max_retries` integer, required
  - `parent_task_id` string, nullable
  - `cycle_id` string, nullable
  - `due_at` string, date-time, nullable
  - `recurrence` string, nullable
  - `effective_status` string, nullable
  - `due_annotation` string, nullable
  - `created_at` string, date-time, required
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

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