Skip to main content
PATCH
/
banking
/
entities
/
{entity_id}
Update Entity (Banking Connectivity)
curl --request PATCH \
  --url https://api-sandbox.y.uno/v1/banking/entities/{entity_id} \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "phone": {
    "country_code": "+1",
    "number": "2025559999"
  },
  "address": {
    "address_line_1": "456 Oak Ave",
    "address_line_2": "Suite 100",
    "building_number_1": "456",
    "building_number_2": null,
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94105",
    "country": "US"
  },
  "entity_detail": {
    "individual": {
      "email": "john.new@example.com"
    }
  }
}
'
{
  "id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "merchant_entity_id": "merchant_user_12345",
  "national_entity": "INDIVIDUAL",
  "phone": {
    "country_code": "+1",
    "number": "2025559999"
  },
  "address": {
    "address_line_1": "456 Oak Ave",
    "address_line_2": "Suite 100",
    "building_number_1": "456",
    "building_number_2": null,
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94105",
    "country": "US"
  },
  "entity_detail": {
    "individual": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.new@example.com",
      "date_of_birth": "1990-01-15",
      "gender": "M",
      "country_of_residence": "US",
      "tax_information": [
        {
          "country": "US",
          "tax_id_last_4": "6789",
          "tax_id_type": "SSN",
          "is_primary": true
        }
      ],
      "document": {
        "document_type": "SSN",
        "document_number_last_4": "6789",
        "issuing_country": "US",
        "issued_at": "2010-01-15",
        "expires_at": "2030-01-15"
      }
    },
    "entity": null
  },
  "created_at": "2026-02-01T10:00:00Z",
  "updated_at": "2026-02-01T12:00:00Z"
}
Update an existing entity’s information. Only include the fields you want to change. The national_entity type cannot be changed after creation.

Authorizations

​
public-api-key
string
header
required
​
private-secret-key
string
header
required

Path Parameters

​
entity_id
string
required

The id of the entity obtained from Create Entity.

Body

application/json
​
account_id
string
required

The unique identifier of the merchant's Yuno account (UUID, 36 characters).

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
merchant_entity_id
string

The merchant's own identifier for this entity.

Example:

"merchant_user_12345"

​
phone
object

Updated phone number.

​
address
object

Updated address. Only include fields that need to change.

​
entity_detail
object

Updated entity details. Only include fields that need to change.

Response

OK

​
id
string

The unique identifier of the entity (prefixed ent_).

Example:

"ent_660e8400-e29b-41d4-a716-446655440000"

​
account_id
string

The merchant's Yuno account identifier.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
merchant_entity_id
string

The merchant's own identifier for this entity.

Example:

"merchant_user_12345"

​
national_entity
enum<string>

The type of entity.

Available options:
INDIVIDUAL,
ENTITY
Example:

"INDIVIDUAL"

​
phone
object
​
address
object
​
entity_detail
object
​
created_at
string

The timestamp when the entity was created (ISO 8601).

Example:

"2026-02-01T10:00:00Z"

​
updated_at
string

The timestamp when the entity was last updated (ISO 8601).

Example:

"2026-02-01T12:00:00Z"