From 9ec29789f03c035fe823c7a10f28f303df798d58 Mon Sep 17 00:00:00 2001 From: Victor Wu Date: Mon, 15 Jun 2026 13:57:41 -0700 Subject: [PATCH 1/2] Add required totalBalance field to InternalAccount Add a totalBalance field (total balance including pending/held funds) alongside the existing balance (spendable). Marked required in the response and rebundled. Co-Authored-By: Claude Opus 4.8 (1M context) --- mintlify/openapi.yaml | 5 +++++ openapi.yaml | 5 +++++ openapi/components/schemas/customers/InternalAccount.yaml | 5 +++++ 3 files changed, 15 insertions(+) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 059e09dd7..6c94c153e 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -12061,6 +12061,7 @@ components: - type - status - balance + - totalBalance - fundingPaymentInstructions - createdAt - updatedAt @@ -12079,6 +12080,10 @@ components: $ref: '#/components/schemas/InternalAccountStatus' balance: $ref: '#/components/schemas/CurrencyAmount' + description: The balance available to spend, excluding pending and held funds + totalBalance: + $ref: '#/components/schemas/CurrencyAmount' + description: The total balance, including pending and held funds fundingPaymentInstructions: type: array description: Payment instructions for funding the account diff --git a/openapi.yaml b/openapi.yaml index 059e09dd7..6c94c153e 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -12061,6 +12061,7 @@ components: - type - status - balance + - totalBalance - fundingPaymentInstructions - createdAt - updatedAt @@ -12079,6 +12080,10 @@ components: $ref: '#/components/schemas/InternalAccountStatus' balance: $ref: '#/components/schemas/CurrencyAmount' + description: The balance available to spend, excluding pending and held funds + totalBalance: + $ref: '#/components/schemas/CurrencyAmount' + description: The total balance, including pending and held funds fundingPaymentInstructions: type: array description: Payment instructions for funding the account diff --git a/openapi/components/schemas/customers/InternalAccount.yaml b/openapi/components/schemas/customers/InternalAccount.yaml index 6c0ea064d..ef8709480 100644 --- a/openapi/components/schemas/customers/InternalAccount.yaml +++ b/openapi/components/schemas/customers/InternalAccount.yaml @@ -4,6 +4,7 @@ required: - type - status - balance + - totalBalance - fundingPaymentInstructions - createdAt - updatedAt @@ -22,6 +23,10 @@ properties: $ref: ./InternalAccountStatus.yaml balance: $ref: ../common/CurrencyAmount.yaml + description: The balance available to spend, excluding pending and held funds + totalBalance: + $ref: ../common/CurrencyAmount.yaml + description: The total balance, including pending and held funds fundingPaymentInstructions: type: array description: Payment instructions for funding the account From 599c17c395c50505dba9b97cace463a2e01855d9 Mon Sep 17 00:00:00 2001 From: Victor Wu Date: Mon, 15 Jun 2026 14:13:06 -0700 Subject: [PATCH 2/2] Fix lint: add totalBalance to InternalAccount examples; example for GbpBeneficiary The new required totalBalance field broke example validation in the PATCH internal-account response and the two internal-account-status webhook examples; add totalBalance to each. Also add property examples to GbpBeneficiary to satisfy schema-properties-have-examples. Co-Authored-By: Claude Opus 4.8 (1M context) --- mintlify/openapi.yaml | 28 +++++++++++++++++++ openapi.yaml | 28 +++++++++++++++++++ .../schemas/common/GbpBeneficiary.yaml | 7 +++++ .../internal_accounts_{id}.yaml | 7 +++++ openapi/webhooks/internal-account-status.yaml | 14 ++++++++++ 5 files changed, 84 insertions(+) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 6c94c153e..d89a5c8e9 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -3911,6 +3911,13 @@ paths: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 12550 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] privateEnabled: true createdAt: '2026-04-08T15:30:00Z' @@ -7662,6 +7669,13 @@ webhooks: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 12500 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] createdAt: '2025-08-01T10:00:00Z' updatedAt: '2025-08-15T14:32:00Z' @@ -7683,6 +7697,13 @@ webhooks: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 10000 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] createdAt: '2025-08-01T10:00:00Z' updatedAt: '2025-08-15T14:32:00Z' @@ -12852,24 +12873,31 @@ components: type: string enum: - INDIVIDUAL + example: INDIVIDUAL fullName: type: string description: The full name of the beneficiary + example: Jane Smith birthDate: type: string description: The birth date of the beneficiary + example: '1990-01-15' nationality: type: string description: The nationality of the beneficiary + example: GB email: type: string description: The email of the beneficiary + example: jane.smith@example.com phoneNumber: type: string description: The phone number of the beneficiary + example: '+447700900123' countryOfResidence: type: string description: The country of residence of the beneficiary + example: GB address: $ref: '#/components/schemas/Address' GbpExternalAccountInfo: diff --git a/openapi.yaml b/openapi.yaml index 6c94c153e..d89a5c8e9 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -3911,6 +3911,13 @@ paths: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 12550 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] privateEnabled: true createdAt: '2026-04-08T15:30:00Z' @@ -7662,6 +7669,13 @@ webhooks: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 12500 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] createdAt: '2025-08-01T10:00:00Z' updatedAt: '2025-08-15T14:32:00Z' @@ -7683,6 +7697,13 @@ webhooks: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 10000 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] createdAt: '2025-08-01T10:00:00Z' updatedAt: '2025-08-15T14:32:00Z' @@ -12852,24 +12873,31 @@ components: type: string enum: - INDIVIDUAL + example: INDIVIDUAL fullName: type: string description: The full name of the beneficiary + example: Jane Smith birthDate: type: string description: The birth date of the beneficiary + example: '1990-01-15' nationality: type: string description: The nationality of the beneficiary + example: GB email: type: string description: The email of the beneficiary + example: jane.smith@example.com phoneNumber: type: string description: The phone number of the beneficiary + example: '+447700900123' countryOfResidence: type: string description: The country of residence of the beneficiary + example: GB address: $ref: '#/components/schemas/Address' GbpExternalAccountInfo: diff --git a/openapi/components/schemas/common/GbpBeneficiary.yaml b/openapi/components/schemas/common/GbpBeneficiary.yaml index d9332d639..b7080e1c4 100644 --- a/openapi/components/schemas/common/GbpBeneficiary.yaml +++ b/openapi/components/schemas/common/GbpBeneficiary.yaml @@ -8,23 +8,30 @@ properties: type: string enum: - INDIVIDUAL + example: INDIVIDUAL fullName: type: string description: The full name of the beneficiary + example: Jane Smith birthDate: type: string description: The birth date of the beneficiary + example: '1990-01-15' nationality: type: string description: The nationality of the beneficiary + example: GB email: type: string description: The email of the beneficiary + example: jane.smith@example.com phoneNumber: type: string description: The phone number of the beneficiary + example: '+447700900123' countryOfResidence: type: string description: The country of residence of the beneficiary + example: GB address: $ref: ./Address.yaml diff --git a/openapi/paths/internal_accounts/internal_accounts_{id}.yaml b/openapi/paths/internal_accounts/internal_accounts_{id}.yaml index d24be082a..49df7defe 100644 --- a/openapi/paths/internal_accounts/internal_accounts_{id}.yaml +++ b/openapi/paths/internal_accounts/internal_accounts_{id}.yaml @@ -90,6 +90,13 @@ patch: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 12550 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] privateEnabled: true createdAt: '2026-04-08T15:30:00Z' diff --git a/openapi/webhooks/internal-account-status.yaml b/openapi/webhooks/internal-account-status.yaml index f31ff7a6e..6078386f0 100644 --- a/openapi/webhooks/internal-account-status.yaml +++ b/openapi/webhooks/internal-account-status.yaml @@ -69,6 +69,13 @@ post: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 12500 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] createdAt: '2025-08-01T10:00:00Z' updatedAt: '2025-08-15T14:32:00Z' @@ -90,6 +97,13 @@ post: name: United States Dollar symbol: $ decimals: 2 + totalBalance: + amount: 10000 + currency: + code: USD + name: United States Dollar + symbol: $ + decimals: 2 fundingPaymentInstructions: [] createdAt: '2025-08-01T10:00:00Z' updatedAt: '2025-08-15T14:32:00Z'