---
title: "Update closure step"
method: PATCH
path: "/cases/{case_id}/closure/steps/{step_id}"
tags: ["Closure"]
---

# Update closure step

`PATCH /cases/{case_id}/closure/steps/{step_id}`

## Request

- Base URL: `https://api.example.com/v1`
- URL: `https://api.example.com/v1/cases/{case_id}/closure/steps/{step_id}`
- Auth: none declared

Update a closure step's status, assignment, due date, or notes.

## Request body

- ClosureStepUpdate
  - `status` 'not_started' | 'in_progress' | 'blocked' | 'waiting' | 'completed' | 'skipped'
  - `blocked_reason` string
  - `assigned_to` string
  - `due_date` string, date
  - `completed_date` string, date
  - `notes` string

## Response `200`

Closure step updated.

- object
  - `data` ClosureStep
    - `id` string
    - `step_type` 'notify_institutions' | 'close_accounts' | 'cancel_recurring_payments' | 'pay_debts' | 'file_final_taxes' | 'obtain_tax_clearance' | 'file_final_accounting' | 'distribute_assets' | 'close_estate_accounts' | 'file_closing_documents' | 'discharge_executor'
    - `title` string
    - `description` string, nullable
    - `status` 'not_started' | 'in_progress' | 'blocked' | 'waiting' | 'completed' | 'skipped'
    - `order` integer: Display order (1-based).
    - `depends_on` string[]: IDs of steps that must be completed before this one.
    - `blocked_reason` string, nullable
    - `assigned_to` string, nullable: Collaborator ID assigned to this step.
    - `due_date` string, date, nullable
    - `completed_date` string, date, nullable
    - `notes` string, nullable
    - `sub_tasks` object[]
      - `id` string
      - `title` string
      - `completed` boolean
      - `institution_contact_id` string, nullable: Reference to the institution contact used.
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `404`: Resource not found.
- `422`: Request validation failed.

---

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