--- title: "Update a Talent Direct Deposit Account" method: PATCH path: "/v1/talent/{talentId}/direct-deposit-accounts/{id}" tags: ["Talent"] --- # Update a Talent Direct Deposit Account `PATCH /v1/talent/{talentId}/direct-deposit-accounts/{id}` ## Request - Base URL: `https://api.avionte.com/front-office` - URL: `https://api.avionte.com/front-office/v1/talent/{talentId}/direct-deposit-accounts/{id}` - Auth: one of: - API key in header `x-api-key` - HTTP bearer Updates information about the specified talent direct deposit account. ## Path parameters - `talentId` string, required - `id` string, required ## Headers - `RequestId` string, uuid: Unique request identifier in UUID format used to correlate request data to log entries and events. - `FrontOfficeTenantId` integer - `Tenant` string ## Request body - DirectDepositAccountPatchData: Fields used to update a single direct deposit account. All fields are optional. Only the fields included in the request are validated and updated. - `bankName` string, nullable: The name of the financial institution. - `accountType` string, nullable: The type of direct deposit account. - `amountType` string, nullable: The calculation used to determine the amount for the direct deposit account. - `amount` number, nullable: The amount allocated to the direct deposit account. - `routingNumber` string, nullable: The routing number for the direct deposit account. - `accountNumber` string, nullable: The account number for the direct deposit account. - `accountOrder` integer, nullable: The order in which deposits are made to the talent's accounts. Should be a unique integer within the list of a talent's bank accounts. - `isArchived` boolean, nullable: An indication of whether the account should be archived. Set to `true` to archive the account or `false` to restore it. - `institutionNumber` string, nullable: The identifier for a financial institution, business, or company. Required to be exactly 3 digits when __accountCountry__ is `Canada`. - `accountCountry` string, nullable: The country in which the bank operates. - `isActivated` boolean, nullable: An indication of whether the account is active. Maps to PayCard active status. - `proxyNumber` string, nullable: The proxy number for PayCard accounts. - `fundingType` string, nullable: The funding type for the account. Applicable to PayCard accounts. - `prenoteSentDate` string, date-time, nullable: The date the prenotification was sent to the bank. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z. - `prenoteApproveDate` string, date-time, nullable: The date the prenotification was approved. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z. ## Response `200` The updated direct deposit account. - DirectDepositBankAccount: A direct deposit account that extends __BankAccount__ with prenotification dates and archive state. - `id` integer: The identifier for the bank account. - `accountType` string, required: The account type. - `routingNumber` string, required: The routing number (9 digits). - `accountNumber` string, required: The account number. - `institutionNumber` string, required: The identifier for a financial institution, business, or company. - `accountName` string, required: The name of the account. - `accountCountry` string, required: The country in which the bank operates. A 2-letter ISO 3166-1 alpha-2 code represents the country (e.g., "US", not "USA"). For details, see the General Guidelines. - `amountType` string, required: The amount type used to calculate the deposit. Options include `Remaining Amount`, `Percent`, and `Fixed Amount`. If `Remaining Amount` is selected, the amount must be set to `0`, and only one of the talent's accounts can use this type. - `amount` number: The dollar amount or percentage that should be distributed to this account. The total percentage for all of the talent's accounts cannot exceed 100%. - `accountOrder` integer: The order in which deposits are made to the talent’s accounts. Should be a unique integer within the list of a talent’s bank accounts. - `isActivated` boolean: An indication of whether the Pay Card has been activated. If the account type is not Pay Card, this value is always false. - `proxyNumber` string, required: A short identifier that links a payment account to a unique reference, such as a phone number or email address, enabling transactions without exposing bank account details. - `fundingType` string, required: The funding type (available for the rapid! PayCard account type). - `isArchived` boolean: An indication of whether the account has been archived (soft-deleted). A value of `true` indicates the account is archived, and `false` indicates the account is active. This property is distinct from `isActivated`, which reflects Pay Card activation state rather than the account's archive state. - `prenoteSentDate` string, date-time, nullable: The date and time the prenotification was sent to the bank. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z. - `prenoteApproveDate` string, date-time, nullable: The date and time the prenotification was approved. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Access Denied - `404`: Not found - `405`: Unsupported method - `406`: Unsupported format(s) indicated by Accept header - `409`: Operation could not be completed due to conflict. - `415`: Unsupported format(s) indicated by the Content-Type header - `429`: Too many requests - `500`: An unexpected error occurred - `502`: Service Unavailable - `504`: Gateway Timeout --- [API](https://skmtc.dev/avionte/apis/bold-front-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/bold-front-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/bold-front-office-api/revisions/bd5996cbaa0f?raw)