---
title: "Update Case Status"
method: PATCH
path: "/api/v1/cases/{case_id}"
tags: ["Cases"]
---

# Update Case Status

`PATCH /api/v1/cases/{case_id}`

Move a case. ``closed_at`` is derived from the status, not supplied.

## Path parameters

- `case_id` string, required

## Request body

- UpdateCaseStatusRequest
  - `status` 'IN_PROGRESS' | 'NEEDS_ACTION' | 'READY' | 'CANCELLED', required

## Response `200`

Successful Response

- CaseResponse
  - `id` string, required
  - `external_id` string, required
  - `status` 'IN_PROGRESS' | 'NEEDS_ACTION' | 'READY' | 'CANCELLED', required
  - `patient_id` string, required
  - `payor` string, nullable, required
  - `plan` string, nullable, required
  - `member_id` string, nullable, required
  - `appointment_external_id` string, nullable, required
  - `appointment_at` string, date-time, nullable, required
  - `appointment_type` string, nullable, required
  - `cpt_codes` string[], required
  - `location` object, required
  - `provider` object, required
  - `custom_data` object, required
  - `source_url` string, nullable, required
  - `closed_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `tasks` CaseTaskResponse[]
    - `id` string, required
    - `type` 'VOB' | 'PA_INITIATION' | 'PA_STATUS' | 'CUSTOM', required
    - `name` string, required
    - `status` 'IN_PROGRESS' | 'WAITING' | 'COMPLETED' | 'NEEDS_ACTION' | 'CANCELLED', required
    - `outcome` string, nullable, required
    - `summary` string, nullable, required
    - `assigned_to_membership_id` string, uuid, nullable, required
    - `campaign_target_id` string, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getprosperapp/apis/prosper-voice.md) · [All operations](https://skmtc.net/getprosperapp/apis/prosper-voice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getprosperapp/prosper-voice/versions/93bd5b9524ee/schema)