---
title: "Update a diligence task"
method: PATCH
path: "/rooms/{id}/checklist/{itemId}"
tags: ["Rooms"]
---

# Update a diligence task

`PATCH /rooms/{id}/checklist/{itemId}`

## Request

- Base URL: `https://dataroom.corgi.com/api/v1`
- URL: `https://dataroom.corgi.com/api/v1/rooms/{id}/checklist/{itemId}`
- Auth: HTTP bearer

Partial update; `status` (TODO / IN_PROGRESS / COMPLETE) auto-manages completedAt, and `attachmentIds` fully replaces the set. An empty-string field is skipped (no-op) per the REST validation convention. Scope: `datarooms:write`.

## Path parameters

- `id` string, required
- `itemId` string, required

## Request body

- object
  - `status` 'TODO' | 'IN_PROGRESS' | 'COMPLETE'
  - `name` string
  - `description` string
  - `assigneeEmail` string
  - `assigneeName` string
  - `dueAt` string, date-time
  - `folderId` string
  - `hideSubmitted` boolean
  - `attachmentIds` string[]
  - `agreementId` string: An agreement the assignee must sign

## Response `200`

Updated

## Other responses

- `400`: Invalid status
- `402`: Plan feature
- `404`: Not found
- `409`: Room is frozen

---

[API](https://skmtc.dev/corgi/apis/dataroom-api.md) - [All operations](https://skmtc.dev/corgi/apis/dataroom-api/llms.txt) - [OpenAPI document](https://skmtc.dev/corgi/apis/dataroom-api/revisions/73f75ef04a00?raw)
