v28

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-044359269.1 KB
Account Holders

Update account holder

Replaces the beneficiary details of an existing account holder.

post/v1/account_holders/{id}

Path parameters

idstring required

Unique identifier of the account holder.

Headers

Idempotency-Keystring required

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Request body

Response

The updated account holder resource

idstring required

Unique identifier of the account holder.

type'account_holder' required

Resource type discriminator.

holder_type'natural_person' | 'business' required

Type of the account holder.

status'pending' | 'active' | 'closed' required

Current account holder status.

created_atstring date-time required

ISO 8601 UTC timestamp when the account holder was created.