Skip to navigation

Update the person holder's address

Only when the account holder document is a CPF and X-Acting-Document is that same CPF. A company account returns 422 holder_update_required. Scope holder.manage. Does not move money; no Idempotency-Key.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

Response

Address updated at the settlement bank

Errors

422
Unprocessable Entity Error