---
title: "Updates a close checklist task"
method: PATCH
path: "/close-checklists/{period}/tasks/{task_id}"
tags: ["Close Checklist"]
---

# Updates a close checklist task

`PATCH /close-checklists/{period}/tasks/{task_id}`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/close-checklists/{period}/tasks/{task_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/close-checklists/:period/tasks/:task_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Partial update of one task's details and assignments. Fields omitted from the body are left unchanged.
Completion and reviewer sign-offs cannot be set or cleared here; use complete-a-close-checklist-task and
sign-off-a-close-checklist-task. A reviewer who has already signed off keeps their place in the queue:
a reviewer_ids list that drops or moves them is rejected with HTTP 409. Every preparer and reviewer must
be an active member of the organization (see list-members). Returns the updated task.

## Path parameters

- `period` string, yearMonth, required
- `task_id` string, uuid, required

## Request body

- UpdateCloseChecklistTaskRequest: Every field is optional; omitted fields are left unchanged.
  - `name` string
  - `notes` string: Replaces the task's notes. Send an empty string to clear them. Read the task first to append.
  - `due_date` string, date: Sets a fixed due date, replacing any business-day due date rule on the task.
  - `accounting_area` string
  - `preparer_id` string, uuid, nullable: A UUID, or null to explicitly select nothing. Omitting the field is not the same as sending null.
  - `reviewer_ids` string[]

## Response `200`

OK

- CloseChecklistTask
  - `id` string, uuid, required
  - `name` string, required
  - `notes` string: Free-text notes on the task.
  - `due_date` string, date
  - `accounting_area` string
  - `status` 'NOT_STARTED' | 'IN_REVIEW' | 'COMPLETE', required: NOT_STARTED: the preparer has not completed the task. IN_REVIEW: completed, but at least one reviewer has not signed off (or, with no reviewers assigned, nobody has reviewed it yet). COMPLETE: completed and every reviewer has signed off.
  - `preparer_id` string, uuid: User id of the assigned preparer.
  - `completed_by` string, uuid: User id of the person who completed the task. Absent for an early task whose recorded preparer is not a user id.
  - `completed_at` string: When the task was completed, as a local date-time in the organization's timezone.
  - `reviewers` CloseChecklistTaskReviewer[], required: The ordered reviewer queue. Reviewers sign off in this order when the organization enforces it.
    - `user_id` string, uuid, required
    - `order` integer, required: Position in the reviewer queue, starting at 1.
    - `signed_off_at` string: When this reviewer signed off, as a local date-time in the organization's timezone. Absent until they sign off.
  - `reviewed_by` string, uuid: User id of the final review sign-off.
  - `reviewed_at` string: When the final review sign-off happened, as a local date-time in the organization's timezone.
  - `link_urls` string[], required
  - `attachment_ids` string[], required: Ids of documents attached to the task.

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/close-checklists/:period/tasks/:task_id/patch.md)

---

[API](https://skmtc.dev/rillet/apis/rillet-accounting-api.md) - [All operations](https://skmtc.dev/rillet/apis/rillet-accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rillet/apis/rillet-accounting-api/revisions/c393d0102005?raw)