--- title: "Changes to Update a beneficial owner" method: PATCH path: "/beneficial-owners/{beneficialOwnerId}" --- # Changes to Update a beneficial owner `PATCH /beneficial-owners/{beneficialOwnerId}` > Every recorded change to this operation, newest first. > 115 revisions in range; 2 not diffed. ## Timeline Changed in 9 of 115 revisions. - **2026-10-28** `d996ddfb9d2b`: 2 info - **2026-10-24** `715332dcb111`: 1 warning - **2026-10-20** `761d1d030cb5`: 1 warning - **2026-10-13** `ddcb4ec73fd0`: 1 warning - **2026-10-05** `6d67fe99049c`: 3 info - **2026-10-05** `32bcbd4023e4`: 2 warning - **2026-10-02** `dfe5a02f2fee`: 9 breaking, 47 warning, 6 info - **2026-05-28** `d0bce562bffd`: 6 warning - **2026-04-27** `5b8a8161eeb3`: 1 info ## Changes - **2026-10-28** `d996ddfb9d2b`: 2 info - added the optional property `details/missingFields` to the response with the `400` status - added the optional property `details/refusalReason` to the response with the `400` status - **2026-10-24** `715332dcb111`: 1 warning - added the new `EXACT_AMOUNT_UNAVAILABLE` enum value to the `code` response property for the response status `400` - **2026-10-20** `761d1d030cb5`: 1 warning - added the new `CARDHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400` - **2026-10-13** `ddcb4ec73fd0`: 1 warning - added the new `ACCOUNTHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400` - **2026-10-05** `6d67fe99049c`: 3 info - removed the `INVALID_PAYREQ_RESPONSE` enum value from the `code` response property for the response status `400` - removed the `LOOKUP_REQUEST_FAILED` enum value from the `code` response property for the response status `400` - removed the `QUOTE_REQUEST_FAILED` enum value from the `code` response property for the response status `400` - **2026-10-05** `32bcbd4023e4`: 2 warning - added the new `AUTH_CREDENTIAL_VERIFICATION_EXPIRED` enum value to the `code` response property for the response status `400` - added the new `AUTH_CREDENTIAL_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400` - **2026-10-02** `dfe5a02f2fee`: 9 breaking, 47 warning, 6 info - the `roles` request property's minItems was increased to `1` - removed the required property `message` from the response with the `400` status - removed the required property `message` from the response with the `401` status - removed the required property `message` from the response with the `404` status - removed the required property `message` from the response with the `500` status - removed the required property `status` from the response with the `400` status - removed the required property `status` from the response with the `401` status - removed the required property `status` from the response with the `404` status - removed the required property `status` from the response with the `500` status - the `personalInfo/email` request property's maxLength was set to `255` - the `personalInfo/firstName` request property's maxLength was set to `250` - the `personalInfo/identifier` request property's maxLength was set to `100` - the `personalInfo/lastName` request property's maxLength was set to `250` - the `personalInfo/middleName` request property's maxLength was set to `250` - added the new `ACCOUNT_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `AUTH_METHOD_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `CARDHOLDER_KYC_NOT_APPROVED` enum value to the `code` response property for the response status `400` - added the new `CUSTOMER_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `DOCUMENTS_REQUIRED` enum value to the `code` response property for the response status `400` - added the new `DOCUMENT_HOLDER_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `END_USER_TERMS_VERSION_NOT_FOUND` enum value to the `code` response property for the response status `400` - added the new `EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400` - added the new `HOLD` enum value to the `kycStatus` response property for the response status `200` - added the new `INSUFFICIENT_FUNDS` enum value to the `code` response property for the response status `400` - added the new `NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `PAYMENT_DOCUMENT_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `PAYMENT_URL_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `PLATFORM_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `QUOTE_EXPIRED` enum value to the `code` response property for the response status `400` - added the new `QUOTE_RATE_UNAVAILABLE` enum value to the `code` response property for the response status `400` - added the new `REQUEST_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `SESSION_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `SMS_OTP_CREDENTIAL_ALREADY_EXISTS` enum value to the `code` response property for the response status `400` - added the new `STABLECOIN_AMOUNT_NOT_REPRESENTABLE` enum value to the `code` response property for the response status `400` - added the new `STABLECOIN_BURN_SOURCE_NOT_SUPPORTED` enum value to the `code` response property for the response status `400` - added the new `STABLECOIN_EXTERNAL_ACCOUNT_LINK_FAILED` enum value to the `code` response property for the response status `400` - added the new `STABLECOIN_EXTERNAL_ACCOUNT_LINK_METHOD_REQUIRED` enum value to the `code` response property for the response status `400` - added the new `STABLECOIN_EXTERNAL_ACCOUNT_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `STABLECOIN_EXTERNAL_ACCOUNT_NOT_LINKED` enum value to the `code` response property for the response status `400` - added the new `STABLECOIN_EXTERNAL_ACCOUNT_NOT_SUPPORTED` enum value to the `code` response property for the response status `400` - …22 more - **2026-05-28** `d0bce562bffd`: 6 warning - added the new `REQUEST_ID_MISSING` enum value to the `code` response property for the response status `401` - added the new `UMA_NOT_FOUND` enum value to the `code` response property for the response status `404` - added the new `WALLET_SIGNATURE_BODY_MISMATCH` enum value to the `code` response property for the response status `401` - added the new `WALLET_SIGNATURE_INVALID` enum value to the `code` response property for the response status `401` - added the new `WALLET_SIGNATURE_MALFORMED` enum value to the `code` response property for the response status `401` - added the new `WALLET_SIGNATURE_MISSING` enum value to the `code` response property for the response status `401` - **2026-04-27** `5b8a8161eeb3`: 1 info - endpoint added --- [Operation](https://skmtc.dev/lightsparkdev/apis/grid-api/docs/beneficial-owners/:beneficialOwnerId/patch.md) - [API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [Page](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/beneficial-owners/:beneficialOwnerId/patch)