Register a holder-ownership removal
Severs ONE holder’s ownership of a transactional account at the DICT (JDPI §8.2.05 Excluir Titular) and, as a consequence, has the DICT DELETE EVERY PIX key bound to that holder ON that account. The account itself stays open and the keys of its OTHER holders are untouched — that is the whole difference from POST /v1/account-closures, which closes the account and deletes every key on it regardless of holder.
Call it when a joint holder leaves, or when a holder’s link to the account ends for any other reason, after that holder has stopped transacting. Deletion at the DICT is not reversible: each key is gone from the national directory and has to be registered again to come back, which restarts its ownership and can open a claim if another institution claimed the key in the meantime.
The target holder is named by personType + document and is deliberately NOT inferred from accountId: the holder being removed is frequently not the one whose credentials made the call. The ISPB is resolved server-side from accountId and never read from the body.
⚠️ A 200 does NOT mean every deletion succeeded. The response carries one outcome row per key the DICT attempted; read result on each (1 = deleted, 0 = not deleted, with resultDescription giving the reason), because only the successes are mirrored into this plugin’s key projection. These rows are narrower than the account-closure ones — document and name are not populated here.
Refusals: 400 PIX-0061 when accountId or account is empty, or accountType is outside 0..4; 404 PIX-2016 when accountId does not resolve; 400 PIX-1000 when the DICT rejects a field, naming it; 404 PIX-1011 when the DICT knows no such holder-and-account binding or no keys under it; 422 PIX-1007 when the DICT refuses the removal in the current state; 503 PIX-1050 when the DICT is unreachable.
Authorizations
JWT bearer token issued by the identity provider.
Body
The account number.
"0007654321"
The CRM account id of the caller (resolves the server-side ISPB).
"acc-123"
The account type (0=Checking,1=Salary,2=Savings,3=Payment,4=PI).
0
The target holder document (CPF/CNPJ).
"82437485000140"
The target holder person type (0=Person,1=Corporate).
1
The branch number of the account.
"0001"
Response
OK
The per-key deletion outcomes.

