---
title: "Update Task Status"
method: PATCH
path: "/tasks/{task_id}"
---

# Update Task Status

`PATCH /tasks/{task_id}`

Updates the status for the specified task. Returns the updated task.

## Path parameters

- `task_id` string, required

## Request body

- AccountTaskUpdateStatus
  - `status` 'todo' | 'dismissed' | 'in-progress' | 'done', required

## Response `200`

Successful Response

- AccountTask
  - `id` string, required
  - `context` union, required
    - TaskContextEmployee
      - `scope` 'employee'
      - `employee_id` string, required
    - TaskContextLegalEntity
      - `scope` 'legal-entity'
      - `legal_entity_id` string, required
  - `definition` AccountTaskDefinition, required
    - `id` string, required
    - `title` string, required
    - `summary` string, nullable
    - `description` string, required
    - `type` 'requirement' | 'data-collection' | 'criteria-collection', required
    - `resources` object[], required
    - `location` LocationRef, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
  - `resolutions` object, required
  - `default_resolution_name` string, required
  - `managed_provider` AccountManagedProvider
    - `id` string, required
    - `name` string, required
  - `status` 'todo' | 'dismissed' | 'in-progress' | 'done', required
  - `period_start_date` string, date, nullable
  - `period_end_date` string, date, nullable
  - `due_date` string, date, nullable
  - `unblocks` AccountTaskDefinition[], required
    - `id` string, required
    - `title` string, required
    - `summary` string, nullable
    - `description` string, required
    - `type` 'requirement' | 'data-collection' | 'criteria-collection', required
    - `resources` object[], required
    - `location` LocationRef, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
  - `fee` union
    - FeeFixed
      - `type` 'fixed'
      - `amount` string, required
    - FeeRange
      - `type` 'range'
      - `min` string, required
      - `max` string, required
    - FeeVariable
      - `type` 'variable'
      - `reason` string, required
  - `eta` AccountTaskETA
    - `estimation` AccountTaskEstimation, required
      - `min` integer, required
      - `max` integer, required
      - `unit` 'hour' | 'day' | 'week' | 'month', required
    - `earliest_date` string, date-time, nullable
    - `latest_date` string, date-time, nullable
  - `priority` 'high' | 'medium' | 'low'
  - `criteria_met` AccountTaskCriteria[], required
    - `key` string, required
    - `reason` string, required
    - `data` union
      - object
      - unknown
  - `tags` string[], nullable

## Other responses

- `422` — Validation Error

---

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