---
title: "Update Entity (Banking Connectivity)"
method: PATCH
path: "/banking/entities/{entity_id}"
tags: ["Entities (Banking Connectivity)"]
---

# Update Entity (Banking Connectivity)

`PATCH /banking/entities/{entity_id}`

## Path parameters

- `entity_id` string, required

## Request body

- object
  - `account_id` string, required — The unique identifier of the merchant's Yuno account (UUID, 36 characters).
  - `merchant_entity_id` string — The merchant's own identifier for this entity.
  - `phone` object — Updated phone number.
    - `country_code` string — The phone country code.
    - `number` string — The phone number without the country code.
  - `address` object — Updated address. Only include fields that need to change.
    - `address_line_1` string — The primary street address.
    - `address_line_2` string, nullable — The secondary address line.
    - `building_number_1` string, nullable — The primary building number.
    - `building_number_2` string, nullable — The secondary building number.
    - `city` string — The city name.
    - `state` string — The state or province.
    - `zip_code` string — The postal or ZIP code.
    - `country` string — The country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
  - `entity_detail` object — Updated entity details. Only include fields that need to change.
    - `individual` object, nullable — Updated individual details.
      - `email` string — Updated email address.
      - `country_of_residence` string — Updated country of residence.
    - `entity` object, nullable — Updated business details.
      - `name` string — Updated business name.

## Response `200`

OK

- object
  - `id` string — The unique identifier of the entity (prefixed `ent_`).
  - `account_id` string — The merchant's Yuno account identifier.
  - `merchant_entity_id` string — The merchant's own identifier for this entity.
  - `national_entity` 'INDIVIDUAL' | 'ENTITY' — The type of entity.
  - `phone` object
    - `country_code` string
    - `number` string
  - `address` object
    - `address_line_1` string
    - `address_line_2` string, nullable
    - `building_number_1` string, nullable
    - `building_number_2` string, nullable
    - `city` string
    - `state` string
    - `zip_code` string
    - `country` string
  - `entity_detail` object
    - `individual` object, nullable
      - `first_name` string
      - `last_name` string
      - `email` string
      - `date_of_birth` string
      - `gender` string
      - `country_of_residence` string
      - `tax_information` object[]
        - `country` string
        - `tax_id_last_4` string
        - `tax_id_type` string
        - `is_primary` boolean
      - `document` object
        - `document_type` string
        - `document_number_last_4` string
        - `issuing_country` string
        - `issued_at` string
        - `expires_at` string, nullable
    - `entity` object, nullable
  - `created_at` string — The timestamp when the entity was created (ISO 8601).
  - `updated_at` string — The timestamp when the entity was last updated (ISO 8601).

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)