---
title: "Simulate Legal Entity Status Change"
method: PATCH
path: "/simulations/legal_entities/{id}/update_status"
---

# Simulate Legal Entity Status Change

`PATCH /simulations/legal_entities/{id}/update_status`

## Request

- Base URL: `https://app.moderntreasury.com/api`
- URL: `https://app.moderntreasury.com/api/simulations/legal_entities/{id}/update_status`
- Auth: HTTP basic

Update Legal Entity Status (sandbox only)

## Path parameters

- `id` string, required

## Request body

- object
  - `status` 'active' | 'suspended' | 'denied', required: The target status for the legal entity. One of `active`, `suspended`, or `denied`. Valid transitions depend on the current status.

## Response `202`

process started

## Other responses

- `405`: not allowed in production
- `422`: unprocessable entity

## Changes

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

[Operation history](https://skmtc.dev/modern-treasury/apis/modern-treasury-api/changes/simulations/legal_entities/:id/update_status/patch.md)

---

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