---
title: "Patch Task"
method: PATCH
path: "/crm/tasks/{task_id}"
tags: ["CRM Service Calls"]
---

# Patch Task

`PATCH /crm/tasks/{task_id}`

Update an existing task by ID.

Send only the fields you want to change. Returns 400 if no fields are provided.

**Path Parameters:**

- **task_id**: The task's CRM record ID.

**Request Body (TaskUpdateRequest):** Same fields as POST /tasks plus `is_completed` (bool)
and `completed_date` (epoch timestamp). All optional — only included fields are updated.

**Response:** The updated task object.

## Path parameters

- `task_id` string, required

## Request body

- TaskUpdateRequest — Request to update an existing task. All fields are optional — only provided fields are updated.
  - `name` string, nullable — Task title
  - `description` string, nullable — Task details
  - `status` string, nullable — Possible values: assigned, in-progress, rejected, reviewsubmit, reviewpass, completed
  - `priority` integer, nullable — Priority 1=highest, 4=lowest
  - `due_date` integer, nullable — Due date (epoch timestamp seconds)
  - `is_completed` boolean, nullable — Mark task as completed
  - `completed_date` integer, nullable — Completion date (epoch timestamp seconds)
  - `subject_type` string, nullable — Entity type linked to task
  - `subject` string, nullable — Linked entity ObjectId
  - `userid` string, nullable — Assigned user ID
  - `action` string, nullable — Task type
  - `action_data` object, nullable — Action-specific details
  - `tags` string[], nullable — List of tags

## Response `200`

Successful Response

- TaskResponse — Response model for a single task.
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `status` string, nullable
  - `priority` integer, nullable
  - `due_date` string, nullable
  - `is_completed` boolean, nullable
  - `completed_date` string, nullable
  - `subject_type` string, nullable
  - `subject` string, nullable
  - `userid` string, nullable
  - `created_by_userid` string, nullable
  - `action` string, nullable
  - `action_data` object, nullable
  - `tags` string[], nullable
  - `created_date` string, nullable
  - `updated_date` string, nullable

## Other responses

- `422` — Validation Error

---

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