---
title: "Update an entity"
method: PATCH
path: "/entities/{entity_id}"
---

# Update an entity

`PATCH /entities/{entity_id}`

## Path parameters

- `entity_id` integer, required

## Request body

- EntityUpdate
  - `name` string
  - `street` string, nullable
  - `state` string, nullable
  - `city` string, nullable
  - `zip` string, nullable
  - `country` string, nullable
  - `user_id` integer — The ID of the user (primary contact) for this entity.
  - `entity_type` string — The type of entity (e.g., 'Individual', 'Corporation', 'Partnership', 'LLC').
  - `business_email` string, email, nullable — The business email address for this entity.
  - `other_email` string, email, nullable — An additional email address for this entity.
  - `inactive` boolean, nullable — Whether this entity is inactive.

## Response `200`

Entity updated

- Entity
  - `id` integer, required
  - `entity_type` string, required
  - `name` string, required
  - `street` string, nullable
  - `state` string, nullable
  - `city` string, nullable
  - `zip` string, nullable
  - `country` string, nullable
  - `tax_return_name` string, required
  - `created_at` string, date-time, required
  - `upload_link` string, uri, required
  - `user` Client, required
    - `id` integer, required
    - `email` string, email, required
    - `fname` string, required
    - `lname` string, required
    - `full_name` string, nullable
    - `time_zone` string, nullable
    - `phone_number` string, nullable
    - `preferred_name` string, nullable
    - `created_at` string, date-time, required
    - `active` boolean, required — Derived from User#paying
    - `assigned_advisor_id` integer, required
    - `work_phone_number` string, nullable
    - `work_phone_extension` string, nullable
    - `work_email` string, email, nullable
    - `external_user_id` string, nullable
    - `assigned_advisor` string, nullable — Assigned advisor full name (string), not an object
  - `business_email` string, nullable
  - `other_email` string, nullable
  - `owners` Client[], required — Owners resolved from owner_ids; serialized as clients
    - `id` integer, required
    - `email` string, email, required
    - `fname` string, required
    - `lname` string, required
    - `full_name` string, nullable
    - `time_zone` string, nullable
    - `phone_number` string, nullable
    - `preferred_name` string, nullable
    - `created_at` string, date-time, required
    - `active` boolean, required — Derived from User#paying
    - `assigned_advisor_id` integer, required
    - `work_phone_number` string, nullable
    - `work_phone_extension` string, nullable
    - `work_email` string, email, nullable
    - `external_user_id` string, nullable
    - `assigned_advisor` string, nullable — Assigned advisor full name (string), not an object
  - `external_entity_id` string, nullable
  - `deleted_at` string, date-time, nullable
  - `hash_id` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/soraban/apis/soraban-private-api.md) · [All operations](https://skmtc.net/soraban/apis/soraban-private-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/soraban/soraban-private-api/versions/0dfdfa10c993/schema)