BVbvnk
Customers

Update customer associate

Changed on

Applies a partial update to an associate. Omitted fields are left unchanged.

  • types, if sent, replaces the associate's existing roles and must contain at least one role.
  • entity.type must match the associate's type (PERSON or BUSINESS_REGISTRATION).
  • entity.reliance is only accepted for customers onboarded with the RELIANCE (Partner-Managed) model.

The request is rejected with 400 if the associate's identity has already been verified and a verified field is changed, if the email address is already used by another associate of the customer, or if the customer was onboarded with Customers API v.1 (error code bvnk:onboarding-accounts:4017).

patch/platform/v2/customers/{customerId}/associates/{associateId}

Request

Path parameters

customerIdstring uuid required
Example:0a184641-30e2-4414-871f-3db1c683900e

Customer id.

associateIdstring uuid required
Example:07b099fa-e1ee-4ad4-9cc4-6f2513a5a240

Associate id.

Request body

typesstring[]

Associate roles. If provided, replaces the associate's existing roles. At least one role is required when the field is sent.

Example request

{
  "entity": {
    "estimatedYearlyIncome": "INCOME_100K_TO_250K",
    "reliance": {
      "identityDocumentMetadata": {
        "type": "PASSPORT",
        "number": "C01X00T47",
        "issueDate": "2021-03-01",
        "expiryDate": "2031-02-28",
        "issuingCountryCode": "DE",
        "kycTimestamp": "2026-04-20T09:15:00Z"
      },
      "biometricLiveness": {
        "livenessTimestamp": "2026-04-20T09:16:30Z"
      },
      "addressVerification": {
        "type": "NON_DOC"
      }
    }
  }
}

Response

Associate updated

idstring uuid
typesstring[]
createdAtstring date-time
updatedAtstring date-time

Changes