@firela/api-types 0.0.0-canary.0327ab9e → 0.0.0-canary.074c27d4

package/dist/index.d.mts

@@ -513,6 +513,54 @@ type BatchTransactionResponseDto = {
      */
     failed: Array<BatchTransactionErrorDto>;
 };
+type CorrectTransactionDto = {
+    /**
+     * Transaction date (ISO 8601 format)
+     */
+    date: string;
+    /**
+     * Transaction flag: * (cleared), ! (pending)
+     */
+    flag?: '*' | '!';
+    /**
+     * Payee name
+     */
+    payee?: string;
+    /**
+     * Transaction narration/description
+     */
+    narration: string;
+    /**
+     * Transaction tags (without # prefix)
+     */
+    tags?: Array<string>;
+    /**
+     * Transaction links (without ^ prefix)
+     */
+    links?: Array<string>;
+    /**
+     * Transaction postings (minimum 1, typically 2 for double-entry)
+     */
+    postings: Array<CreatePostingDto>;
+    /**
+     * Transaction-level metadata
+     */
+    meta?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Unique key for idempotent transaction creation. If provided, duplicate requests with the same key will return the existing transaction.
+     */
+    idempotencyKey?: string;
+    /**
+     * Auto-create accounts if not found. When true, missing accounts will be automatically created. When false (default for API), missing accounts will cause a validation error. Set to true for quick entry scenarios where you want to create accounts on-the-fly.
+     */
+    autoCreateAccounts?: boolean;
+    /**
+     * Reason for correcting/superseding the original transaction
+     */
+    correctionReason?: string;
+};
 type PostingDetailDto = {
     /**
      * Posting ID
@@ -523,9 +571,9 @@ type PostingDetailDto = {
      */
     accountId: string;
     /**
-     * Account name
+     * Fully-qualified Beancount account path
      */
-    accountName: string;
+    account: string;
     /**
      * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
      */
@@ -609,9 +657,9 @@ type TransactionDetailDto = {
      */
     status: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
     /**
-     * Source type (how the transaction was created)
+     * Source type (free-form string from transaction metadata, e.g. import, api)
      */
-    sourceType?: 'NLP' | 'CSV' | 'OCR' | 'API';
+    sourceType?: string;
     /**
      * Source platform (e.g., alipay, wechat)
      */
@@ -636,6 +684,14 @@ type TransactionDetailDto = {
      * Correction reason (if voided or superseded)
      */
     correctionReason?: string;
+    /**
+     * ID of the transaction that supersedes this one (set when status=SUPERSEDED)
+     */
+    supersededBy?: string;
+    /**
+     * ID of the transaction this one corrected/replaced (back-link on the replacement)
+     */
+    originalTxn?: string;
 };
 /**
  * Transaction flag
@@ -645,10 +701,6 @@ type flag2 = 'CLEARED' | 'PENDING' | 'PADDING' | 'SUMMARIZE' | 'TRANSFER' | 'CON
  * Transaction status
  */
 type status2 = 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
-/**
- * Source type (how the transaction was created)
- */
-type sourceType = 'NLP' | 'CSV' | 'OCR' | 'API';
 type TransactionListResponseDto = {
     /**
      * List of transactions
@@ -775,9 +827,9 @@ type TransactionSummaryDto = {
      */
     accountName?: string;
     /**
-     * Source type (NLP, CSV, OCR, API)
+     * Source type (free-form string from transaction metadata, e.g. import, api)
      */
-    sourceType?: 'NLP' | 'CSV' | 'OCR' | 'API';
+    sourceType?: string;
     /**
      * Source platform (e.g., alipay, wechat)
      */
@@ -819,7 +871,7 @@ type ReviewSummaryDto = {
      */
     matchReasons: Array<string>;
     /**
-     * Source type (NLP, CSV, OCR, API)
+     * Source type (free-form string from transaction metadata, e.g. import, api)
      */
     sourceType: string;
     /**
@@ -906,7 +958,7 @@ type DecisionOptionDto = {
     /**
      * The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)
      */
-    value: string;
+    value: 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
     /**
      * i18n message key for display label (e.g., review.payee.accept.label)
      */
@@ -920,6 +972,10 @@ type DecisionOptionDto = {
      */
     recommended?: boolean;
 };
+/**
+ * The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)
+ */
+type value = 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
 type ReviewDetailDto = {
     /**
      * Review item ID
@@ -956,7 +1012,7 @@ type ReviewDetailDto = {
      */
     matchReasons: Array<string>;
     /**
-     * Source type (NLP, CSV, OCR, API)
+     * Source type (free-form string from transaction metadata, e.g. import, api)
      */
     sourceType: string;
     /**
@@ -1008,9 +1064,9 @@ type ReviewDetailDto = {
 };
 type ResolveReviewDto = {
     /**
-     * Decision action. Available actions vary by review type: DUPLICATE: UPGRADE_REPLACE, LINK_KEEP_BOTH, IGNORE_NEW, CONFIRM_DIFFERENT | RULE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | PAYEE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | ACCOUNT_VALIDATION: ACCEPT, CHOOSE_OTHER, CANCEL | PIPELINE_ERROR: FIX, IGNORE, CANCEL
+     * Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.
      */
-    action: string;
+    action: 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
     /**
      * Additional data for the decision (e.g., selected account ID)
      */
@@ -1018,6 +1074,10 @@ type ResolveReviewDto = {
         [key: string]: unknown;
     };
 };
+/**
+ * Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.
+ */
+type action = 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
 type ResolveResultDto = {
     /**
      * Whether resolution was successful
@@ -1072,7 +1132,7 @@ type BatchResolveDto = {
     /**
      * Decision action to apply to all items
      */
-    action: string;
+    action: 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
     /**
      * Additional data for the decision
      */
@@ -3448,7 +3508,7 @@ type status4 = 'success' | 'pending' | 'error';
 /**
  * Action taken or requested
  */
-type action = 'created' | 'ask' | 'confirm' | 'confirm_duplicate' | 'confirm_rule' | 'confirm_account' | 'confirm_payee' | 'cancel';
+type action2 = 'created' | 'ask' | 'confirm' | 'confirm_duplicate' | 'confirm_rule' | 'confirm_account' | 'confirm_payee' | 'cancel';
 /**
  * Transaction intent detected by EntityRouter (v6.0: 5 core intents). Frontend uses this to render scenario-specific form fields.
  */
@@ -4097,6 +4157,18 @@ type TransactionControllerCreateBatchData = {
     requestBody: BatchCreateTransactionDto;
 };
 type TransactionControllerCreateBatchResponse = BatchTransactionResponseDto;
+type TransactionControllerCorrectData = {
+    /**
+     * Original transaction ID to correct
+     */
+    id: string;
+    /**
+     * Region code for tenant context
+     */
+    region: 'cn' | 'us' | 'de' | 'gb';
+    requestBody: CorrectTransactionDto;
+};
+type TransactionControllerCorrectResponse = TransactionDetailDto;
 type TransactionControllerSuggestTagsData = {
     /**
      * Max suggestions (1-100, default 10)
@@ -5332,6 +5404,29 @@ type $OpenApiTs = {
             };
         };
     };
+    '/api/v1/{region}/bean/transactions/{id}/correct': {
+        post: {
+            req: TransactionControllerCorrectData;
+            res: {
+                /**
+                 * Corrected transaction created
+                 */
+                201: TransactionDetailDto;
+                /**
+                 * Original transaction not found
+                 */
+                404: ApiProblemResponseDto;
+                /**
+                 * Original no longer ACTIVE (concurrent modification)
+                 */
+                409: ApiProblemResponseDto;
+                /**
+                 * Pipeline validation failed (does not balance, invalid accounts)
+                 */
+                422: ApiProblemResponseDto;
+            };
+        };
+    };
     '/api/v1/{region}/bean/transactions/tags': {
         get: {
             req: TransactionControllerSuggestTagsData;
@@ -7197,6 +7292,17 @@ declare class BeanTransactionsService {
      * @throws ApiError
      */
     static transactionControllerCreateBatch(data: TransactionControllerCreateBatchData): CancelablePromise<TransactionControllerCreateBatchResponse>;
+    /**
+     * Correct (supersede) a transaction
+     * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
+     * @param data The data for the request.
+     * @param data.id Original transaction ID to correct
+     * @param data.region Region code for tenant context
+     * @param data.requestBody
+     * @returns TransactionDetailDto Corrected transaction created
+     * @throws ApiError
+     */
+    static transactionControllerCorrect(data: TransactionControllerCorrectData): CancelablePromise<TransactionControllerCorrectResponse>;
     /**
      * Suggest transaction tags
      * Returns distinct tags from the user ACTIVE transactions, sorted by usage, for autocomplete. Optional q performs a case-insensitive prefix match.
@@ -7476,4 +7582,4 @@ type OpenAPIConfig = {
 };
 declare const OpenAPI: OpenAPIConfig;
 
-export { type $OpenApiTs, type AccountControllerCloseData, type AccountControllerCloseResponse, type AccountControllerCreateData, type AccountControllerCreateResponse, type AccountControllerDeleteData, type AccountControllerDeleteResponse, type AccountControllerFindAllData, type AccountControllerFindAllResponse, type AccountControllerFindOneData, type AccountControllerFindOneResponse, type AccountControllerReopenData, type AccountControllerReopenResponse, type AccountControllerUpdateData, type AccountControllerUpdateResponse, type AccountExchangeRateWarningDto, type AccountItemDto, type AccountItemWithAssetClassDto, type AccountListResponseDto, type AccountResponseDto, type AccountStandardListResponseDto, type AccountStandardResponseDto, type AccountStandardsControllerGetRegionsData, type AccountStandardsControllerGetRegionsResponse, type AccountStandardsControllerGetTemplateMetadataData, type AccountStandardsControllerGetTemplateMetadataResponse, type AccountStandardsControllerGetTemplatesData, type AccountStandardsControllerGetTemplatesResponse, type AccountsResponseDto, type AccountsSummaryDto, type AmountRangeDto, type AnonymousLoginDto, type ApiKeysControllerCreateApiKeyResponse, type ApiProblemResponseDto, type AssetClassAccountsResponseDto, type AssetClassGroupDto, type AssetClassSummaryDto, type AuthControllerAccessTokenLoginData, type AuthControllerAccessTokenLoginResponse, type BackfillSnapshotsBody, type BackfillSnapshotsResponse, type BalanceByCurrencyDto, type BalanceControllerGetBalanceData, type BalanceControllerGetBalanceResponse, type BalanceControllerGetMultiCurrencyBalanceData, type BalanceControllerGetMultiCurrencyBalanceResponse, type BalanceResponseDto, type BatchCreateTransactionDto, type BatchResolveDto, type BatchResolveResultDto, type BatchTransactionErrorDto, type BatchTransactionResponseDto, BeanAccountsService, BeanBalancesService, BeanCommoditiesService, BeanTransactionsService, type BulkCreateRulesDto, type BulkCreateRulesResponseDto, type CacheControllerFlushCacheResponse, type CashFlowByCurrencyDto, type CashFlowResponseDto, type CloseAccountDto, type CommodityControllerBulkCreateData, type CommodityControllerBulkCreateResponse, type CommodityControllerCreateData, type CommodityControllerCreateResponse, type CommodityControllerDeleteData, type CommodityControllerDeleteResponse, type CommodityControllerFindAllData, type CommodityControllerFindAllResponse, type CommodityControllerFindOneData, type CommodityControllerFindOneResponse, type CommodityControllerGetOrCreateData, type CommodityControllerGetOrCreateResponse, type CommodityControllerUpdateData, type CommodityControllerUpdateResponse, type CommodityListResponseDto, type CommodityResponseDto, type ConfirmMatchDto, type ConvertedCashFlowDto, type ConvertedNetWorthDto, type CreateAccountDto, type CreateCommodityDto, type CreatePayeeDto, type CreatePayeeProfileDto, type CreatePlatformDto, type CreatePostingDto, type CreateRecurringRuleDto, type CreateRuleFromTransactionDto, type CreateTransactionDto, type CreateTransactionRuleDto, type CurrencyBalanceDto, type DashboardControllerGetAccountsData, type DashboardControllerGetAccountsResponse, type DashboardControllerGetCashFlowData, type DashboardControllerGetCashFlowResponse, type DashboardControllerGetNetWorthData, type DashboardControllerGetNetWorthResponse, type DecisionOptionDto, type DeleteOwnUserDto, type EnterNowDto, type ExchangeRateControllerGetExchangeRateData, type ExchangeRateControllerGetExchangeRateResponse, type ExchangeRateWarningDto, type ExpectedTransactionControllerConfirmMatchData, type ExpectedTransactionControllerConfirmMatchResponse, type ExpectedTransactionControllerEnterNowData, type ExpectedTransactionControllerEnterNowResponse, type ExpectedTransactionControllerFindAllData, type ExpectedTransactionControllerFindAllResponse, type ExpectedTransactionControllerFindOneData, type ExpectedTransactionControllerFindOneResponse, type ExpectedTransactionControllerFindOverdueData, type ExpectedTransactionControllerFindOverdueResponse, type ExpectedTransactionControllerSkipData, type ExpectedTransactionControllerSkipResponse, type ExpectedTransactionControllerUndoSkipData, type ExpectedTransactionControllerUndoSkipResponse, type ExpectedTransactionControllerUnmatchData, type ExpectedTransactionControllerUnmatchResponse, type ExpectedTransactionListResponseDto, type ExpectedTransactionResponseDto, type ExpectedTransactionRuleDto, type ExportControllerExportBeancountResponse, type ExportRulesResponseDto, type FileImportControllerIdentifyFileData, type FileImportControllerIdentifyFileResponse, type FileImportControllerImportBeancountData, type FileImportControllerImportBeancountResponse, type FileImportControllerImportFileData, type FileImportControllerImportFileResponse, type FileImportDto, type ForecastControllerGetForecastData, type ForecastControllerGetForecastResponse, type ForecastItemDto, type ForecastResponseDto, type GenerateSnapshotBody, type GenerateSnapshotResponse, type HealthControllerCheckDatabaseResponse, type HealthControllerCheckOpenBbResponse, type HealthControllerCheckRedisResponse, type HealthControllerGetCircuitBreakersHealthResponse, type HealthControllerGetHealthResponse, type HealthControllerGetMetricsResponse, type HealthControllerResetCircuitBreakerData, type HealthControllerResetCircuitBreakerResponse, HealthService, type IdentifyResultDto, type ImportErrorDto, type ImportResultDto, type ImporterConfigControllerGetConfigData, type ImporterConfigControllerGetConfigResponse, type ImporterConfigControllerResetConfigData, type ImporterConfigControllerResetConfigResponse, type ImporterConfigControllerUpdateConfigData, type ImporterConfigControllerUpdateConfigResponse, type ImporterConfigDataDto, type ImporterConfigDto, type InfoControllerGetInfoResponse, type MapperDefaultsDto, type MonthlyForecastDto, type MultiCurrencyBalanceResponseDto, type MultiCurrencyPointDto, type NetWorthByCurrencyDto, type NetWorthResponseDto, type NlpAccountConfirmationDataDto, type NlpAlternativePayeeDto, type NlpControllerClearSessionData, type NlpControllerClearSessionResponse, type NlpControllerGetSessionData, type NlpControllerGetSessionResponse, type NlpControllerProcessNaturalLanguageData, type NlpControllerProcessNaturalLanguageResponse, type NlpDefaultAccountsDto, type NlpDuplicateConfirmationDataDto, type NlpParsedDataDto, type NlpPayeeConfirmationDataDto, type NlpResponseDto, type NlpRuleConfirmationDataDto, type NlpSimilarityDto, type NlpSourceTransactionDto, type NlpSuggestedAccountDto, type NlpSuggestedAccountsDto, type NlpSuggestedPayeeDto, type NlpTargetTransactionDto, type NlpTransactionInfoDto, OpenAPI, type OpenAPIConfig, type ParserTelemetryReportDto, type PayeeAutocompleteResponseDto, type PayeeControllerAutocompleteData, type PayeeControllerAutocompleteResponse, type PayeeControllerCreateData, type PayeeControllerCreateResponse, type PayeeControllerDeleteData, type PayeeControllerDeleteResponse, type PayeeControllerFindAllData, type PayeeControllerFindAllResponse, type PayeeControllerFindOneData, type PayeeControllerFindOneResponse, type PayeeControllerGetTopPayeesData, type PayeeControllerGetTopPayeesResponse, type PayeeControllerUpdateData, type PayeeControllerUpdateResponse, type PayeeListResponseDto, type PayeeProfileAdminControllerCreateData, type PayeeProfileAdminControllerCreateResponse, type PayeeProfileAdminControllerDeleteData, type PayeeProfileAdminControllerDeleteResponse, type PayeeProfileAdminControllerFindAllData, type PayeeProfileAdminControllerFindAllResponse, type PayeeProfileAdminControllerFindOneData, type PayeeProfileAdminControllerFindOneResponse, type PayeeProfileAdminControllerUnverifyData, type PayeeProfileAdminControllerUnverifyResponse, type PayeeProfileAdminControllerUpdateData, type PayeeProfileAdminControllerUpdateResponse, type PayeeProfileAdminControllerVerifyData, type PayeeProfileAdminControllerVerifyResponse, type PayeeProfileListResponseDto, type PayeeProfileResponseDto, type PayeeResponseDto, type PayeeStatsResponseDto, type PlatformControllerCreateData, type PlatformControllerCreateResponse, type PlatformControllerDeleteData, type PlatformControllerDeleteResponse, type PlatformControllerFindAllResponse, type PlatformControllerGetPlatformListResponse, type PlatformControllerMatchPlatformsData, type PlatformControllerMatchPlatformsResponse, type PlatformControllerUpdateData, type PlatformControllerUpdateResponse, type PlatformGroupDto, type PortfolioTrendsResponseDto, type PostingDetailDto, type PostingResponseDto, type ProcessNlpDto, type PropertyControllerDeleteData, type PropertyControllerDeleteResponse, type PropertyControllerGetAllResponse, type PropertyControllerGetByKeyData, type PropertyControllerGetByKeyResponse, type PropertyControllerUpdateData, type PropertyControllerUpdateResponse, type ProviderSyncConfigDto, type ProviderSyncControllerGetSupportedProvidersData, type ProviderSyncControllerGetSupportedProvidersResponse, type ProviderSyncControllerIsProviderSupportedData, type ProviderSyncControllerIsProviderSupportedResponse, type ProviderSyncControllerSyncData, type ProviderSyncControllerSyncResponse, type ProviderSyncDto, type ProviderSyncResponseDto, ProviderSyncService, type RecurringMatchInfoDto, type RecurringRuleControllerCreateData, type RecurringRuleControllerCreateFromTransactionData, type RecurringRuleControllerCreateFromTransactionResponse, type RecurringRuleControllerCreateResponse, type RecurringRuleControllerDeleteData, type RecurringRuleControllerDeleteResponse, type RecurringRuleControllerFindAllData, type RecurringRuleControllerFindAllResponse, type RecurringRuleControllerFindOneData, type RecurringRuleControllerFindOneResponse, type RecurringRuleControllerGetWithStatsData, type RecurringRuleControllerGetWithStatsResponse, type RecurringRuleControllerUpdateData, type RecurringRuleControllerUpdateResponse, type RecurringRuleResponseDto, type RecurringRuleWithStatsResponseDto, type RecurringSuggestionDto, type RegionConfigDto, type RegionInfoDto, type RegionsMetadataResponseDto, type ReopenAccountDto, type ReportingControllerBackfillSnapshotsData, type ReportingControllerBackfillSnapshotsResponse, type ReportingControllerGenerateSnapshotData, type ReportingControllerGenerateSnapshotResponse, type ReportingControllerGetPortfolioTrendsData, type ReportingControllerGetPortfolioTrendsResponse, type ResolveResultDto, type ResolveReviewDto, type ReviewControllerBatchResolveData, type ReviewControllerBatchResolveResponse, type ReviewControllerFindAllData, type ReviewControllerFindAllResponse, type ReviewControllerFindOneData, type ReviewControllerFindOneResponse, type ReviewControllerGetStatsData, type ReviewControllerGetStatsResponse, type ReviewControllerResolveData, type ReviewControllerResolveResponse, type ReviewControllerUndoData, type ReviewControllerUndoResponse, type ReviewDetailDto, type ReviewItemPreviewDto, type ReviewListResponseDto, type ReviewStatsDto, type ReviewSummaryDto, type RuleStatisticsResponseDto, type SignupDto, type SupportedProvidersResponseDto, type TagSuggestionDto, type TagSuggestionsResponseDto, type TelemetryControllerReportTelemetryData, type TelemetryControllerReportTelemetryResponse, type TemplateMetadataDto, type TemplateMetadataResponseDto, type TestRuleDto, type TestRuleResponseDto, type TimeSeriesPointDto, type TransactionControllerCreateBatchData, type TransactionControllerCreateBatchResponse, type TransactionControllerCreateData, type TransactionControllerCreateResponse, type TransactionControllerDeleteData, type TransactionControllerDeleteResponse, type TransactionControllerGetDetailData, type TransactionControllerGetDetailResponse, type TransactionControllerListData, type TransactionControllerListResponse, type TransactionControllerSuggestTagsData, type TransactionControllerSuggestTagsResponse, type TransactionControllerUpdateData, type TransactionControllerUpdateResponse, type TransactionDetailDto, type TransactionListResponseDto, type TransactionResponseDto, type TransactionRuleControllerBulkCreateData, type TransactionRuleControllerBulkCreateResponse, type TransactionRuleControllerCreateData, type TransactionRuleControllerCreateResponse, type TransactionRuleControllerDeleteData, type TransactionRuleControllerDeleteResponse, type TransactionRuleControllerExportData, type TransactionRuleControllerExportResponse, type TransactionRuleControllerGetDetailData, type TransactionRuleControllerGetDetailResponse, type TransactionRuleControllerGetStatisticsData, type TransactionRuleControllerGetStatisticsResponse, type TransactionRuleControllerListData, type TransactionRuleControllerListResponse, type TransactionRuleControllerTestData, type TransactionRuleControllerTestResponse, type TransactionRuleControllerUpdateData, type TransactionRuleControllerUpdateResponse, type TransactionRuleControllerValidateData, type TransactionRuleControllerValidateResponse, type TransactionRuleListResponseDto, type TransactionRuleResponseDto, type TransactionSummaryDto, type TrendSummaryDto, type UndoResultDto, type UpdateAccountDto, type UpdateCommodityDto, type UpdateConfigDataDto, type UpdateImporterConfigDto, type UpdateMapperDefaultsDto, type UpdatePayeeDto, type UpdatePayeeProfileDto, type UpdatePlatformDto, type UpdatePropertyDto, type UpdateRecurringRuleDto, type UpdateTransactionDto, type UpdateTransactionRuleDto, type UpdateUserSettingDto, type UserControllerDeleteOwnUserData, type UserControllerDeleteOwnUserResponse, type UserControllerDeleteUserData, type UserControllerDeleteUserResponse, type UserControllerGetAllUserSettingsByPageData, type UserControllerGetAllUserSettingsByPageResponse, type UserControllerGetAssetLiabilitySummaryResponse, type UserControllerGetUserData, type UserControllerGetUserInfoData, type UserControllerGetUserInfoResponse, type UserControllerGetUserResponse, type UserControllerSignupUserData, type UserControllerSignupUserResponse, type UserControllerUpdateUserSettingData, type UserControllerUpdateUserSettingResponse, type ValidateRuleDto, type ValidateRuleResponseDto, type VersionedConfigDto, type action, type assetClass, type assetSubType, type bookingMethod, type branchType, type category, type colorScheme, type confidenceLevel, type conflictStrategy, type dataSource, type equitySubType, type flag, type flag2, type frequency, type importerId, type intent, type investmentAction, type learningSource, type liabilitySubType, type matchLogic, type paymentSource, type period, type source, type sourceType, type status, type status2, type status3, type status4, type suggestedFrequency, type type, type type2, type type3, type viewMode };
+export { type $OpenApiTs, type AccountControllerCloseData, type AccountControllerCloseResponse, type AccountControllerCreateData, type AccountControllerCreateResponse, type AccountControllerDeleteData, type AccountControllerDeleteResponse, type AccountControllerFindAllData, type AccountControllerFindAllResponse, type AccountControllerFindOneData, type AccountControllerFindOneResponse, type AccountControllerReopenData, type AccountControllerReopenResponse, type AccountControllerUpdateData, type AccountControllerUpdateResponse, type AccountExchangeRateWarningDto, type AccountItemDto, type AccountItemWithAssetClassDto, type AccountListResponseDto, type AccountResponseDto, type AccountStandardListResponseDto, type AccountStandardResponseDto, type AccountStandardsControllerGetRegionsData, type AccountStandardsControllerGetRegionsResponse, type AccountStandardsControllerGetTemplateMetadataData, type AccountStandardsControllerGetTemplateMetadataResponse, type AccountStandardsControllerGetTemplatesData, type AccountStandardsControllerGetTemplatesResponse, type AccountsResponseDto, type AccountsSummaryDto, type AmountRangeDto, type AnonymousLoginDto, type ApiKeysControllerCreateApiKeyResponse, type ApiProblemResponseDto, type AssetClassAccountsResponseDto, type AssetClassGroupDto, type AssetClassSummaryDto, type AuthControllerAccessTokenLoginData, type AuthControllerAccessTokenLoginResponse, type BackfillSnapshotsBody, type BackfillSnapshotsResponse, type BalanceByCurrencyDto, type BalanceControllerGetBalanceData, type BalanceControllerGetBalanceResponse, type BalanceControllerGetMultiCurrencyBalanceData, type BalanceControllerGetMultiCurrencyBalanceResponse, type BalanceResponseDto, type BatchCreateTransactionDto, type BatchResolveDto, type BatchResolveResultDto, type BatchTransactionErrorDto, type BatchTransactionResponseDto, BeanAccountsService, BeanBalancesService, BeanCommoditiesService, BeanTransactionsService, type BulkCreateRulesDto, type BulkCreateRulesResponseDto, type CacheControllerFlushCacheResponse, type CashFlowByCurrencyDto, type CashFlowResponseDto, type CloseAccountDto, type CommodityControllerBulkCreateData, type CommodityControllerBulkCreateResponse, type CommodityControllerCreateData, type CommodityControllerCreateResponse, type CommodityControllerDeleteData, type CommodityControllerDeleteResponse, type CommodityControllerFindAllData, type CommodityControllerFindAllResponse, type CommodityControllerFindOneData, type CommodityControllerFindOneResponse, type CommodityControllerGetOrCreateData, type CommodityControllerGetOrCreateResponse, type CommodityControllerUpdateData, type CommodityControllerUpdateResponse, type CommodityListResponseDto, type CommodityResponseDto, type ConfirmMatchDto, type ConvertedCashFlowDto, type ConvertedNetWorthDto, type CorrectTransactionDto, type CreateAccountDto, type CreateCommodityDto, type CreatePayeeDto, type CreatePayeeProfileDto, type CreatePlatformDto, type CreatePostingDto, type CreateRecurringRuleDto, type CreateRuleFromTransactionDto, type CreateTransactionDto, type CreateTransactionRuleDto, type CurrencyBalanceDto, type DashboardControllerGetAccountsData, type DashboardControllerGetAccountsResponse, type DashboardControllerGetCashFlowData, type DashboardControllerGetCashFlowResponse, type DashboardControllerGetNetWorthData, type DashboardControllerGetNetWorthResponse, type DecisionOptionDto, type DeleteOwnUserDto, type EnterNowDto, type ExchangeRateControllerGetExchangeRateData, type ExchangeRateControllerGetExchangeRateResponse, type ExchangeRateWarningDto, type ExpectedTransactionControllerConfirmMatchData, type ExpectedTransactionControllerConfirmMatchResponse, type ExpectedTransactionControllerEnterNowData, type ExpectedTransactionControllerEnterNowResponse, type ExpectedTransactionControllerFindAllData, type ExpectedTransactionControllerFindAllResponse, type ExpectedTransactionControllerFindOneData, type ExpectedTransactionControllerFindOneResponse, type ExpectedTransactionControllerFindOverdueData, type ExpectedTransactionControllerFindOverdueResponse, type ExpectedTransactionControllerSkipData, type ExpectedTransactionControllerSkipResponse, type ExpectedTransactionControllerUndoSkipData, type ExpectedTransactionControllerUndoSkipResponse, type ExpectedTransactionControllerUnmatchData, type ExpectedTransactionControllerUnmatchResponse, type ExpectedTransactionListResponseDto, type ExpectedTransactionResponseDto, type ExpectedTransactionRuleDto, type ExportControllerExportBeancountResponse, type ExportRulesResponseDto, type FileImportControllerIdentifyFileData, type FileImportControllerIdentifyFileResponse, type FileImportControllerImportBeancountData, type FileImportControllerImportBeancountResponse, type FileImportControllerImportFileData, type FileImportControllerImportFileResponse, type FileImportDto, type ForecastControllerGetForecastData, type ForecastControllerGetForecastResponse, type ForecastItemDto, type ForecastResponseDto, type GenerateSnapshotBody, type GenerateSnapshotResponse, type HealthControllerCheckDatabaseResponse, type HealthControllerCheckOpenBbResponse, type HealthControllerCheckRedisResponse, type HealthControllerGetCircuitBreakersHealthResponse, type HealthControllerGetHealthResponse, type HealthControllerGetMetricsResponse, type HealthControllerResetCircuitBreakerData, type HealthControllerResetCircuitBreakerResponse, HealthService, type IdentifyResultDto, type ImportErrorDto, type ImportResultDto, type ImporterConfigControllerGetConfigData, type ImporterConfigControllerGetConfigResponse, type ImporterConfigControllerResetConfigData, type ImporterConfigControllerResetConfigResponse, type ImporterConfigControllerUpdateConfigData, type ImporterConfigControllerUpdateConfigResponse, type ImporterConfigDataDto, type ImporterConfigDto, type InfoControllerGetInfoResponse, type MapperDefaultsDto, type MonthlyForecastDto, type MultiCurrencyBalanceResponseDto, type MultiCurrencyPointDto, type NetWorthByCurrencyDto, type NetWorthResponseDto, type NlpAccountConfirmationDataDto, type NlpAlternativePayeeDto, type NlpControllerClearSessionData, type NlpControllerClearSessionResponse, type NlpControllerGetSessionData, type NlpControllerGetSessionResponse, type NlpControllerProcessNaturalLanguageData, type NlpControllerProcessNaturalLanguageResponse, type NlpDefaultAccountsDto, type NlpDuplicateConfirmationDataDto, type NlpParsedDataDto, type NlpPayeeConfirmationDataDto, type NlpResponseDto, type NlpRuleConfirmationDataDto, type NlpSimilarityDto, type NlpSourceTransactionDto, type NlpSuggestedAccountDto, type NlpSuggestedAccountsDto, type NlpSuggestedPayeeDto, type NlpTargetTransactionDto, type NlpTransactionInfoDto, OpenAPI, type OpenAPIConfig, type ParserTelemetryReportDto, type PayeeAutocompleteResponseDto, type PayeeControllerAutocompleteData, type PayeeControllerAutocompleteResponse, type PayeeControllerCreateData, type PayeeControllerCreateResponse, type PayeeControllerDeleteData, type PayeeControllerDeleteResponse, type PayeeControllerFindAllData, type PayeeControllerFindAllResponse, type PayeeControllerFindOneData, type PayeeControllerFindOneResponse, type PayeeControllerGetTopPayeesData, type PayeeControllerGetTopPayeesResponse, type PayeeControllerUpdateData, type PayeeControllerUpdateResponse, type PayeeListResponseDto, type PayeeProfileAdminControllerCreateData, type PayeeProfileAdminControllerCreateResponse, type PayeeProfileAdminControllerDeleteData, type PayeeProfileAdminControllerDeleteResponse, type PayeeProfileAdminControllerFindAllData, type PayeeProfileAdminControllerFindAllResponse, type PayeeProfileAdminControllerFindOneData, type PayeeProfileAdminControllerFindOneResponse, type PayeeProfileAdminControllerUnverifyData, type PayeeProfileAdminControllerUnverifyResponse, type PayeeProfileAdminControllerUpdateData, type PayeeProfileAdminControllerUpdateResponse, type PayeeProfileAdminControllerVerifyData, type PayeeProfileAdminControllerVerifyResponse, type PayeeProfileListResponseDto, type PayeeProfileResponseDto, type PayeeResponseDto, type PayeeStatsResponseDto, type PlatformControllerCreateData, type PlatformControllerCreateResponse, type PlatformControllerDeleteData, type PlatformControllerDeleteResponse, type PlatformControllerFindAllResponse, type PlatformControllerGetPlatformListResponse, type PlatformControllerMatchPlatformsData, type PlatformControllerMatchPlatformsResponse, type PlatformControllerUpdateData, type PlatformControllerUpdateResponse, type PlatformGroupDto, type PortfolioTrendsResponseDto, type PostingDetailDto, type PostingResponseDto, type ProcessNlpDto, type PropertyControllerDeleteData, type PropertyControllerDeleteResponse, type PropertyControllerGetAllResponse, type PropertyControllerGetByKeyData, type PropertyControllerGetByKeyResponse, type PropertyControllerUpdateData, type PropertyControllerUpdateResponse, type ProviderSyncConfigDto, type ProviderSyncControllerGetSupportedProvidersData, type ProviderSyncControllerGetSupportedProvidersResponse, type ProviderSyncControllerIsProviderSupportedData, type ProviderSyncControllerIsProviderSupportedResponse, type ProviderSyncControllerSyncData, type ProviderSyncControllerSyncResponse, type ProviderSyncDto, type ProviderSyncResponseDto, ProviderSyncService, type RecurringMatchInfoDto, type RecurringRuleControllerCreateData, type RecurringRuleControllerCreateFromTransactionData, type RecurringRuleControllerCreateFromTransactionResponse, type RecurringRuleControllerCreateResponse, type RecurringRuleControllerDeleteData, type RecurringRuleControllerDeleteResponse, type RecurringRuleControllerFindAllData, type RecurringRuleControllerFindAllResponse, type RecurringRuleControllerFindOneData, type RecurringRuleControllerFindOneResponse, type RecurringRuleControllerGetWithStatsData, type RecurringRuleControllerGetWithStatsResponse, type RecurringRuleControllerUpdateData, type RecurringRuleControllerUpdateResponse, type RecurringRuleResponseDto, type RecurringRuleWithStatsResponseDto, type RecurringSuggestionDto, type RegionConfigDto, type RegionInfoDto, type RegionsMetadataResponseDto, type ReopenAccountDto, type ReportingControllerBackfillSnapshotsData, type ReportingControllerBackfillSnapshotsResponse, type ReportingControllerGenerateSnapshotData, type ReportingControllerGenerateSnapshotResponse, type ReportingControllerGetPortfolioTrendsData, type ReportingControllerGetPortfolioTrendsResponse, type ResolveResultDto, type ResolveReviewDto, type ReviewControllerBatchResolveData, type ReviewControllerBatchResolveResponse, type ReviewControllerFindAllData, type ReviewControllerFindAllResponse, type ReviewControllerFindOneData, type ReviewControllerFindOneResponse, type ReviewControllerGetStatsData, type ReviewControllerGetStatsResponse, type ReviewControllerResolveData, type ReviewControllerResolveResponse, type ReviewControllerUndoData, type ReviewControllerUndoResponse, type ReviewDetailDto, type ReviewItemPreviewDto, type ReviewListResponseDto, type ReviewStatsDto, type ReviewSummaryDto, type RuleStatisticsResponseDto, type SignupDto, type SupportedProvidersResponseDto, type TagSuggestionDto, type TagSuggestionsResponseDto, type TelemetryControllerReportTelemetryData, type TelemetryControllerReportTelemetryResponse, type TemplateMetadataDto, type TemplateMetadataResponseDto, type TestRuleDto, type TestRuleResponseDto, type TimeSeriesPointDto, type TransactionControllerCorrectData, type TransactionControllerCorrectResponse, type TransactionControllerCreateBatchData, type TransactionControllerCreateBatchResponse, type TransactionControllerCreateData, type TransactionControllerCreateResponse, type TransactionControllerDeleteData, type TransactionControllerDeleteResponse, type TransactionControllerGetDetailData, type TransactionControllerGetDetailResponse, type TransactionControllerListData, type TransactionControllerListResponse, type TransactionControllerSuggestTagsData, type TransactionControllerSuggestTagsResponse, type TransactionControllerUpdateData, type TransactionControllerUpdateResponse, type TransactionDetailDto, type TransactionListResponseDto, type TransactionResponseDto, type TransactionRuleControllerBulkCreateData, type TransactionRuleControllerBulkCreateResponse, type TransactionRuleControllerCreateData, type TransactionRuleControllerCreateResponse, type TransactionRuleControllerDeleteData, type TransactionRuleControllerDeleteResponse, type TransactionRuleControllerExportData, type TransactionRuleControllerExportResponse, type TransactionRuleControllerGetDetailData, type TransactionRuleControllerGetDetailResponse, type TransactionRuleControllerGetStatisticsData, type TransactionRuleControllerGetStatisticsResponse, type TransactionRuleControllerListData, type TransactionRuleControllerListResponse, type TransactionRuleControllerTestData, type TransactionRuleControllerTestResponse, type TransactionRuleControllerUpdateData, type TransactionRuleControllerUpdateResponse, type TransactionRuleControllerValidateData, type TransactionRuleControllerValidateResponse, type TransactionRuleListResponseDto, type TransactionRuleResponseDto, type TransactionSummaryDto, type TrendSummaryDto, type UndoResultDto, type UpdateAccountDto, type UpdateCommodityDto, type UpdateConfigDataDto, type UpdateImporterConfigDto, type UpdateMapperDefaultsDto, type UpdatePayeeDto, type UpdatePayeeProfileDto, type UpdatePlatformDto, type UpdatePropertyDto, type UpdateRecurringRuleDto, type UpdateTransactionDto, type UpdateTransactionRuleDto, type UpdateUserSettingDto, type UserControllerDeleteOwnUserData, type UserControllerDeleteOwnUserResponse, type UserControllerDeleteUserData, type UserControllerDeleteUserResponse, type UserControllerGetAllUserSettingsByPageData, type UserControllerGetAllUserSettingsByPageResponse, type UserControllerGetAssetLiabilitySummaryResponse, type UserControllerGetUserData, type UserControllerGetUserInfoData, type UserControllerGetUserInfoResponse, type UserControllerGetUserResponse, type UserControllerSignupUserData, type UserControllerSignupUserResponse, type UserControllerUpdateUserSettingData, type UserControllerUpdateUserSettingResponse, type ValidateRuleDto, type ValidateRuleResponseDto, type VersionedConfigDto, type action, type action2, type assetClass, type assetSubType, type bookingMethod, type branchType, type category, type colorScheme, type confidenceLevel, type conflictStrategy, type dataSource, type equitySubType, type flag, type flag2, type frequency, type importerId, type intent, type investmentAction, type learningSource, type liabilitySubType, type matchLogic, type paymentSource, type period, type source, type status, type status2, type status3, type status4, type suggestedFrequency, type type, type type2, type type3, type value, type viewMode };

package/dist/index.d.ts

@@ -513,6 +513,54 @@ type BatchTransactionResponseDto = {
      */
     failed: Array<BatchTransactionErrorDto>;
 };
+type CorrectTransactionDto = {
+    /**
+     * Transaction date (ISO 8601 format)
+     */
+    date: string;
+    /**
+     * Transaction flag: * (cleared), ! (pending)
+     */
+    flag?: '*' | '!';
+    /**
+     * Payee name
+     */
+    payee?: string;
+    /**
+     * Transaction narration/description
+     */
+    narration: string;
+    /**
+     * Transaction tags (without # prefix)
+     */
+    tags?: Array<string>;
+    /**
+     * Transaction links (without ^ prefix)
+     */
+    links?: Array<string>;
+    /**
+     * Transaction postings (minimum 1, typically 2 for double-entry)
+     */
+    postings: Array<CreatePostingDto>;
+    /**
+     * Transaction-level metadata
+     */
+    meta?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Unique key for idempotent transaction creation. If provided, duplicate requests with the same key will return the existing transaction.
+     */
+    idempotencyKey?: string;
+    /**
+     * Auto-create accounts if not found. When true, missing accounts will be automatically created. When false (default for API), missing accounts will cause a validation error. Set to true for quick entry scenarios where you want to create accounts on-the-fly.
+     */
+    autoCreateAccounts?: boolean;
+    /**
+     * Reason for correcting/superseding the original transaction
+     */
+    correctionReason?: string;
+};
 type PostingDetailDto = {
     /**
      * Posting ID
@@ -523,9 +571,9 @@ type PostingDetailDto = {
      */
     accountId: string;
     /**
-     * Account name
+     * Fully-qualified Beancount account path
      */
-    accountName: string;
+    account: string;
     /**
      * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
      */
@@ -609,9 +657,9 @@ type TransactionDetailDto = {
      */
     status: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
     /**
-     * Source type (how the transaction was created)
+     * Source type (free-form string from transaction metadata, e.g. import, api)
      */
-    sourceType?: 'NLP' | 'CSV' | 'OCR' | 'API';
+    sourceType?: string;
     /**
      * Source platform (e.g., alipay, wechat)
      */
@@ -636,6 +684,14 @@ type TransactionDetailDto = {
      * Correction reason (if voided or superseded)
      */
     correctionReason?: string;
+    /**
+     * ID of the transaction that supersedes this one (set when status=SUPERSEDED)
+     */
+    supersededBy?: string;
+    /**
+     * ID of the transaction this one corrected/replaced (back-link on the replacement)
+     */
+    originalTxn?: string;
 };
 /**
  * Transaction flag
@@ -645,10 +701,6 @@ type flag2 = 'CLEARED' | 'PENDING' | 'PADDING' | 'SUMMARIZE' | 'TRANSFER' | 'CON
  * Transaction status
  */
 type status2 = 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
-/**
- * Source type (how the transaction was created)
- */
-type sourceType = 'NLP' | 'CSV' | 'OCR' | 'API';
 type TransactionListResponseDto = {
     /**
      * List of transactions
@@ -775,9 +827,9 @@ type TransactionSummaryDto = {
      */
     accountName?: string;
     /**
-     * Source type (NLP, CSV, OCR, API)
+     * Source type (free-form string from transaction metadata, e.g. import, api)
      */
-    sourceType?: 'NLP' | 'CSV' | 'OCR' | 'API';
+    sourceType?: string;
     /**
      * Source platform (e.g., alipay, wechat)
      */
@@ -819,7 +871,7 @@ type ReviewSummaryDto = {
      */
     matchReasons: Array<string>;
     /**
-     * Source type (NLP, CSV, OCR, API)
+     * Source type (free-form string from transaction metadata, e.g. import, api)
      */
     sourceType: string;
     /**
@@ -906,7 +958,7 @@ type DecisionOptionDto = {
     /**
      * The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)
      */
-    value: string;
+    value: 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
     /**
      * i18n message key for display label (e.g., review.payee.accept.label)
      */
@@ -920,6 +972,10 @@ type DecisionOptionDto = {
      */
     recommended?: boolean;
 };
+/**
+ * The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)
+ */
+type value = 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
 type ReviewDetailDto = {
     /**
      * Review item ID
@@ -956,7 +1012,7 @@ type ReviewDetailDto = {
      */
     matchReasons: Array<string>;
     /**
-     * Source type (NLP, CSV, OCR, API)
+     * Source type (free-form string from transaction metadata, e.g. import, api)
      */
     sourceType: string;
     /**
@@ -1008,9 +1064,9 @@ type ReviewDetailDto = {
 };
 type ResolveReviewDto = {
     /**
-     * Decision action. Available actions vary by review type: DUPLICATE: UPGRADE_REPLACE, LINK_KEEP_BOTH, IGNORE_NEW, CONFIRM_DIFFERENT | RULE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | PAYEE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | ACCOUNT_VALIDATION: ACCEPT, CHOOSE_OTHER, CANCEL | PIPELINE_ERROR: FIX, IGNORE, CANCEL
+     * Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.
      */
-    action: string;
+    action: 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
     /**
      * Additional data for the decision (e.g., selected account ID)
      */
@@ -1018,6 +1074,10 @@ type ResolveReviewDto = {
         [key: string]: unknown;
     };
 };
+/**
+ * Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.
+ */
+type action = 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
 type ResolveResultDto = {
     /**
      * Whether resolution was successful
@@ -1072,7 +1132,7 @@ type BatchResolveDto = {
     /**
      * Decision action to apply to all items
      */
-    action: string;
+    action: 'UPGRADE_REPLACE' | 'LINK_KEEP_BOTH' | 'IGNORE_NEW' | 'CONFIRM_DIFFERENT' | 'ACCEPT' | 'REJECT' | 'ACCEPT_AND_LEARN' | 'CHOOSE_OTHER' | 'CANCEL' | 'FIX' | 'IGNORE';
     /**
      * Additional data for the decision
      */
@@ -3448,7 +3508,7 @@ type status4 = 'success' | 'pending' | 'error';
 /**
  * Action taken or requested
  */
-type action = 'created' | 'ask' | 'confirm' | 'confirm_duplicate' | 'confirm_rule' | 'confirm_account' | 'confirm_payee' | 'cancel';
+type action2 = 'created' | 'ask' | 'confirm' | 'confirm_duplicate' | 'confirm_rule' | 'confirm_account' | 'confirm_payee' | 'cancel';
 /**
  * Transaction intent detected by EntityRouter (v6.0: 5 core intents). Frontend uses this to render scenario-specific form fields.
  */
@@ -4097,6 +4157,18 @@ type TransactionControllerCreateBatchData = {
     requestBody: BatchCreateTransactionDto;
 };
 type TransactionControllerCreateBatchResponse = BatchTransactionResponseDto;
+type TransactionControllerCorrectData = {
+    /**
+     * Original transaction ID to correct
+     */
+    id: string;
+    /**
+     * Region code for tenant context
+     */
+    region: 'cn' | 'us' | 'de' | 'gb';
+    requestBody: CorrectTransactionDto;
+};
+type TransactionControllerCorrectResponse = TransactionDetailDto;
 type TransactionControllerSuggestTagsData = {
     /**
      * Max suggestions (1-100, default 10)
@@ -5332,6 +5404,29 @@ type $OpenApiTs = {
             };
         };
     };
+    '/api/v1/{region}/bean/transactions/{id}/correct': {
+        post: {
+            req: TransactionControllerCorrectData;
+            res: {
+                /**
+                 * Corrected transaction created
+                 */
+                201: TransactionDetailDto;
+                /**
+                 * Original transaction not found
+                 */
+                404: ApiProblemResponseDto;
+                /**
+                 * Original no longer ACTIVE (concurrent modification)
+                 */
+                409: ApiProblemResponseDto;
+                /**
+                 * Pipeline validation failed (does not balance, invalid accounts)
+                 */
+                422: ApiProblemResponseDto;
+            };
+        };
+    };
     '/api/v1/{region}/bean/transactions/tags': {
         get: {
             req: TransactionControllerSuggestTagsData;
@@ -7197,6 +7292,17 @@ declare class BeanTransactionsService {
      * @throws ApiError
      */
     static transactionControllerCreateBatch(data: TransactionControllerCreateBatchData): CancelablePromise<TransactionControllerCreateBatchResponse>;
+    /**
+     * Correct (supersede) a transaction
+     * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
+     * @param data The data for the request.
+     * @param data.id Original transaction ID to correct
+     * @param data.region Region code for tenant context
+     * @param data.requestBody
+     * @returns TransactionDetailDto Corrected transaction created
+     * @throws ApiError
+     */
+    static transactionControllerCorrect(data: TransactionControllerCorrectData): CancelablePromise<TransactionControllerCorrectResponse>;
     /**
      * Suggest transaction tags
      * Returns distinct tags from the user ACTIVE transactions, sorted by usage, for autocomplete. Optional q performs a case-insensitive prefix match.
@@ -7476,4 +7582,4 @@ type OpenAPIConfig = {
 };
 declare const OpenAPI: OpenAPIConfig;
 
-export { type $OpenApiTs, type AccountControllerCloseData, type AccountControllerCloseResponse, type AccountControllerCreateData, type AccountControllerCreateResponse, type AccountControllerDeleteData, type AccountControllerDeleteResponse, type AccountControllerFindAllData, type AccountControllerFindAllResponse, type AccountControllerFindOneData, type AccountControllerFindOneResponse, type AccountControllerReopenData, type AccountControllerReopenResponse, type AccountControllerUpdateData, type AccountControllerUpdateResponse, type AccountExchangeRateWarningDto, type AccountItemDto, type AccountItemWithAssetClassDto, type AccountListResponseDto, type AccountResponseDto, type AccountStandardListResponseDto, type AccountStandardResponseDto, type AccountStandardsControllerGetRegionsData, type AccountStandardsControllerGetRegionsResponse, type AccountStandardsControllerGetTemplateMetadataData, type AccountStandardsControllerGetTemplateMetadataResponse, type AccountStandardsControllerGetTemplatesData, type AccountStandardsControllerGetTemplatesResponse, type AccountsResponseDto, type AccountsSummaryDto, type AmountRangeDto, type AnonymousLoginDto, type ApiKeysControllerCreateApiKeyResponse, type ApiProblemResponseDto, type AssetClassAccountsResponseDto, type AssetClassGroupDto, type AssetClassSummaryDto, type AuthControllerAccessTokenLoginData, type AuthControllerAccessTokenLoginResponse, type BackfillSnapshotsBody, type BackfillSnapshotsResponse, type BalanceByCurrencyDto, type BalanceControllerGetBalanceData, type BalanceControllerGetBalanceResponse, type BalanceControllerGetMultiCurrencyBalanceData, type BalanceControllerGetMultiCurrencyBalanceResponse, type BalanceResponseDto, type BatchCreateTransactionDto, type BatchResolveDto, type BatchResolveResultDto, type BatchTransactionErrorDto, type BatchTransactionResponseDto, BeanAccountsService, BeanBalancesService, BeanCommoditiesService, BeanTransactionsService, type BulkCreateRulesDto, type BulkCreateRulesResponseDto, type CacheControllerFlushCacheResponse, type CashFlowByCurrencyDto, type CashFlowResponseDto, type CloseAccountDto, type CommodityControllerBulkCreateData, type CommodityControllerBulkCreateResponse, type CommodityControllerCreateData, type CommodityControllerCreateResponse, type CommodityControllerDeleteData, type CommodityControllerDeleteResponse, type CommodityControllerFindAllData, type CommodityControllerFindAllResponse, type CommodityControllerFindOneData, type CommodityControllerFindOneResponse, type CommodityControllerGetOrCreateData, type CommodityControllerGetOrCreateResponse, type CommodityControllerUpdateData, type CommodityControllerUpdateResponse, type CommodityListResponseDto, type CommodityResponseDto, type ConfirmMatchDto, type ConvertedCashFlowDto, type ConvertedNetWorthDto, type CreateAccountDto, type CreateCommodityDto, type CreatePayeeDto, type CreatePayeeProfileDto, type CreatePlatformDto, type CreatePostingDto, type CreateRecurringRuleDto, type CreateRuleFromTransactionDto, type CreateTransactionDto, type CreateTransactionRuleDto, type CurrencyBalanceDto, type DashboardControllerGetAccountsData, type DashboardControllerGetAccountsResponse, type DashboardControllerGetCashFlowData, type DashboardControllerGetCashFlowResponse, type DashboardControllerGetNetWorthData, type DashboardControllerGetNetWorthResponse, type DecisionOptionDto, type DeleteOwnUserDto, type EnterNowDto, type ExchangeRateControllerGetExchangeRateData, type ExchangeRateControllerGetExchangeRateResponse, type ExchangeRateWarningDto, type ExpectedTransactionControllerConfirmMatchData, type ExpectedTransactionControllerConfirmMatchResponse, type ExpectedTransactionControllerEnterNowData, type ExpectedTransactionControllerEnterNowResponse, type ExpectedTransactionControllerFindAllData, type ExpectedTransactionControllerFindAllResponse, type ExpectedTransactionControllerFindOneData, type ExpectedTransactionControllerFindOneResponse, type ExpectedTransactionControllerFindOverdueData, type ExpectedTransactionControllerFindOverdueResponse, type ExpectedTransactionControllerSkipData, type ExpectedTransactionControllerSkipResponse, type ExpectedTransactionControllerUndoSkipData, type ExpectedTransactionControllerUndoSkipResponse, type ExpectedTransactionControllerUnmatchData, type ExpectedTransactionControllerUnmatchResponse, type ExpectedTransactionListResponseDto, type ExpectedTransactionResponseDto, type ExpectedTransactionRuleDto, type ExportControllerExportBeancountResponse, type ExportRulesResponseDto, type FileImportControllerIdentifyFileData, type FileImportControllerIdentifyFileResponse, type FileImportControllerImportBeancountData, type FileImportControllerImportBeancountResponse, type FileImportControllerImportFileData, type FileImportControllerImportFileResponse, type FileImportDto, type ForecastControllerGetForecastData, type ForecastControllerGetForecastResponse, type ForecastItemDto, type ForecastResponseDto, type GenerateSnapshotBody, type GenerateSnapshotResponse, type HealthControllerCheckDatabaseResponse, type HealthControllerCheckOpenBbResponse, type HealthControllerCheckRedisResponse, type HealthControllerGetCircuitBreakersHealthResponse, type HealthControllerGetHealthResponse, type HealthControllerGetMetricsResponse, type HealthControllerResetCircuitBreakerData, type HealthControllerResetCircuitBreakerResponse, HealthService, type IdentifyResultDto, type ImportErrorDto, type ImportResultDto, type ImporterConfigControllerGetConfigData, type ImporterConfigControllerGetConfigResponse, type ImporterConfigControllerResetConfigData, type ImporterConfigControllerResetConfigResponse, type ImporterConfigControllerUpdateConfigData, type ImporterConfigControllerUpdateConfigResponse, type ImporterConfigDataDto, type ImporterConfigDto, type InfoControllerGetInfoResponse, type MapperDefaultsDto, type MonthlyForecastDto, type MultiCurrencyBalanceResponseDto, type MultiCurrencyPointDto, type NetWorthByCurrencyDto, type NetWorthResponseDto, type NlpAccountConfirmationDataDto, type NlpAlternativePayeeDto, type NlpControllerClearSessionData, type NlpControllerClearSessionResponse, type NlpControllerGetSessionData, type NlpControllerGetSessionResponse, type NlpControllerProcessNaturalLanguageData, type NlpControllerProcessNaturalLanguageResponse, type NlpDefaultAccountsDto, type NlpDuplicateConfirmationDataDto, type NlpParsedDataDto, type NlpPayeeConfirmationDataDto, type NlpResponseDto, type NlpRuleConfirmationDataDto, type NlpSimilarityDto, type NlpSourceTransactionDto, type NlpSuggestedAccountDto, type NlpSuggestedAccountsDto, type NlpSuggestedPayeeDto, type NlpTargetTransactionDto, type NlpTransactionInfoDto, OpenAPI, type OpenAPIConfig, type ParserTelemetryReportDto, type PayeeAutocompleteResponseDto, type PayeeControllerAutocompleteData, type PayeeControllerAutocompleteResponse, type PayeeControllerCreateData, type PayeeControllerCreateResponse, type PayeeControllerDeleteData, type PayeeControllerDeleteResponse, type PayeeControllerFindAllData, type PayeeControllerFindAllResponse, type PayeeControllerFindOneData, type PayeeControllerFindOneResponse, type PayeeControllerGetTopPayeesData, type PayeeControllerGetTopPayeesResponse, type PayeeControllerUpdateData, type PayeeControllerUpdateResponse, type PayeeListResponseDto, type PayeeProfileAdminControllerCreateData, type PayeeProfileAdminControllerCreateResponse, type PayeeProfileAdminControllerDeleteData, type PayeeProfileAdminControllerDeleteResponse, type PayeeProfileAdminControllerFindAllData, type PayeeProfileAdminControllerFindAllResponse, type PayeeProfileAdminControllerFindOneData, type PayeeProfileAdminControllerFindOneResponse, type PayeeProfileAdminControllerUnverifyData, type PayeeProfileAdminControllerUnverifyResponse, type PayeeProfileAdminControllerUpdateData, type PayeeProfileAdminControllerUpdateResponse, type PayeeProfileAdminControllerVerifyData, type PayeeProfileAdminControllerVerifyResponse, type PayeeProfileListResponseDto, type PayeeProfileResponseDto, type PayeeResponseDto, type PayeeStatsResponseDto, type PlatformControllerCreateData, type PlatformControllerCreateResponse, type PlatformControllerDeleteData, type PlatformControllerDeleteResponse, type PlatformControllerFindAllResponse, type PlatformControllerGetPlatformListResponse, type PlatformControllerMatchPlatformsData, type PlatformControllerMatchPlatformsResponse, type PlatformControllerUpdateData, type PlatformControllerUpdateResponse, type PlatformGroupDto, type PortfolioTrendsResponseDto, type PostingDetailDto, type PostingResponseDto, type ProcessNlpDto, type PropertyControllerDeleteData, type PropertyControllerDeleteResponse, type PropertyControllerGetAllResponse, type PropertyControllerGetByKeyData, type PropertyControllerGetByKeyResponse, type PropertyControllerUpdateData, type PropertyControllerUpdateResponse, type ProviderSyncConfigDto, type ProviderSyncControllerGetSupportedProvidersData, type ProviderSyncControllerGetSupportedProvidersResponse, type ProviderSyncControllerIsProviderSupportedData, type ProviderSyncControllerIsProviderSupportedResponse, type ProviderSyncControllerSyncData, type ProviderSyncControllerSyncResponse, type ProviderSyncDto, type ProviderSyncResponseDto, ProviderSyncService, type RecurringMatchInfoDto, type RecurringRuleControllerCreateData, type RecurringRuleControllerCreateFromTransactionData, type RecurringRuleControllerCreateFromTransactionResponse, type RecurringRuleControllerCreateResponse, type RecurringRuleControllerDeleteData, type RecurringRuleControllerDeleteResponse, type RecurringRuleControllerFindAllData, type RecurringRuleControllerFindAllResponse, type RecurringRuleControllerFindOneData, type RecurringRuleControllerFindOneResponse, type RecurringRuleControllerGetWithStatsData, type RecurringRuleControllerGetWithStatsResponse, type RecurringRuleControllerUpdateData, type RecurringRuleControllerUpdateResponse, type RecurringRuleResponseDto, type RecurringRuleWithStatsResponseDto, type RecurringSuggestionDto, type RegionConfigDto, type RegionInfoDto, type RegionsMetadataResponseDto, type ReopenAccountDto, type ReportingControllerBackfillSnapshotsData, type ReportingControllerBackfillSnapshotsResponse, type ReportingControllerGenerateSnapshotData, type ReportingControllerGenerateSnapshotResponse, type ReportingControllerGetPortfolioTrendsData, type ReportingControllerGetPortfolioTrendsResponse, type ResolveResultDto, type ResolveReviewDto, type ReviewControllerBatchResolveData, type ReviewControllerBatchResolveResponse, type ReviewControllerFindAllData, type ReviewControllerFindAllResponse, type ReviewControllerFindOneData, type ReviewControllerFindOneResponse, type ReviewControllerGetStatsData, type ReviewControllerGetStatsResponse, type ReviewControllerResolveData, type ReviewControllerResolveResponse, type ReviewControllerUndoData, type ReviewControllerUndoResponse, type ReviewDetailDto, type ReviewItemPreviewDto, type ReviewListResponseDto, type ReviewStatsDto, type ReviewSummaryDto, type RuleStatisticsResponseDto, type SignupDto, type SupportedProvidersResponseDto, type TagSuggestionDto, type TagSuggestionsResponseDto, type TelemetryControllerReportTelemetryData, type TelemetryControllerReportTelemetryResponse, type TemplateMetadataDto, type TemplateMetadataResponseDto, type TestRuleDto, type TestRuleResponseDto, type TimeSeriesPointDto, type TransactionControllerCreateBatchData, type TransactionControllerCreateBatchResponse, type TransactionControllerCreateData, type TransactionControllerCreateResponse, type TransactionControllerDeleteData, type TransactionControllerDeleteResponse, type TransactionControllerGetDetailData, type TransactionControllerGetDetailResponse, type TransactionControllerListData, type TransactionControllerListResponse, type TransactionControllerSuggestTagsData, type TransactionControllerSuggestTagsResponse, type TransactionControllerUpdateData, type TransactionControllerUpdateResponse, type TransactionDetailDto, type TransactionListResponseDto, type TransactionResponseDto, type TransactionRuleControllerBulkCreateData, type TransactionRuleControllerBulkCreateResponse, type TransactionRuleControllerCreateData, type TransactionRuleControllerCreateResponse, type TransactionRuleControllerDeleteData, type TransactionRuleControllerDeleteResponse, type TransactionRuleControllerExportData, type TransactionRuleControllerExportResponse, type TransactionRuleControllerGetDetailData, type TransactionRuleControllerGetDetailResponse, type TransactionRuleControllerGetStatisticsData, type TransactionRuleControllerGetStatisticsResponse, type TransactionRuleControllerListData, type TransactionRuleControllerListResponse, type TransactionRuleControllerTestData, type TransactionRuleControllerTestResponse, type TransactionRuleControllerUpdateData, type TransactionRuleControllerUpdateResponse, type TransactionRuleControllerValidateData, type TransactionRuleControllerValidateResponse, type TransactionRuleListResponseDto, type TransactionRuleResponseDto, type TransactionSummaryDto, type TrendSummaryDto, type UndoResultDto, type UpdateAccountDto, type UpdateCommodityDto, type UpdateConfigDataDto, type UpdateImporterConfigDto, type UpdateMapperDefaultsDto, type UpdatePayeeDto, type UpdatePayeeProfileDto, type UpdatePlatformDto, type UpdatePropertyDto, type UpdateRecurringRuleDto, type UpdateTransactionDto, type UpdateTransactionRuleDto, type UpdateUserSettingDto, type UserControllerDeleteOwnUserData, type UserControllerDeleteOwnUserResponse, type UserControllerDeleteUserData, type UserControllerDeleteUserResponse, type UserControllerGetAllUserSettingsByPageData, type UserControllerGetAllUserSettingsByPageResponse, type UserControllerGetAssetLiabilitySummaryResponse, type UserControllerGetUserData, type UserControllerGetUserInfoData, type UserControllerGetUserInfoResponse, type UserControllerGetUserResponse, type UserControllerSignupUserData, type UserControllerSignupUserResponse, type UserControllerUpdateUserSettingData, type UserControllerUpdateUserSettingResponse, type ValidateRuleDto, type ValidateRuleResponseDto, type VersionedConfigDto, type action, type assetClass, type assetSubType, type bookingMethod, type branchType, type category, type colorScheme, type confidenceLevel, type conflictStrategy, type dataSource, type equitySubType, type flag, type flag2, type frequency, type importerId, type intent, type investmentAction, type learningSource, type liabilitySubType, type matchLogic, type paymentSource, type period, type source, type sourceType, type status, type status2, type status3, type status4, type suggestedFrequency, type type, type type2, type type3, type viewMode };
+export { type $OpenApiTs, type AccountControllerCloseData, type AccountControllerCloseResponse, type AccountControllerCreateData, type AccountControllerCreateResponse, type AccountControllerDeleteData, type AccountControllerDeleteResponse, type AccountControllerFindAllData, type AccountControllerFindAllResponse, type AccountControllerFindOneData, type AccountControllerFindOneResponse, type AccountControllerReopenData, type AccountControllerReopenResponse, type AccountControllerUpdateData, type AccountControllerUpdateResponse, type AccountExchangeRateWarningDto, type AccountItemDto, type AccountItemWithAssetClassDto, type AccountListResponseDto, type AccountResponseDto, type AccountStandardListResponseDto, type AccountStandardResponseDto, type AccountStandardsControllerGetRegionsData, type AccountStandardsControllerGetRegionsResponse, type AccountStandardsControllerGetTemplateMetadataData, type AccountStandardsControllerGetTemplateMetadataResponse, type AccountStandardsControllerGetTemplatesData, type AccountStandardsControllerGetTemplatesResponse, type AccountsResponseDto, type AccountsSummaryDto, type AmountRangeDto, type AnonymousLoginDto, type ApiKeysControllerCreateApiKeyResponse, type ApiProblemResponseDto, type AssetClassAccountsResponseDto, type AssetClassGroupDto, type AssetClassSummaryDto, type AuthControllerAccessTokenLoginData, type AuthControllerAccessTokenLoginResponse, type BackfillSnapshotsBody, type BackfillSnapshotsResponse, type BalanceByCurrencyDto, type BalanceControllerGetBalanceData, type BalanceControllerGetBalanceResponse, type BalanceControllerGetMultiCurrencyBalanceData, type BalanceControllerGetMultiCurrencyBalanceResponse, type BalanceResponseDto, type BatchCreateTransactionDto, type BatchResolveDto, type BatchResolveResultDto, type BatchTransactionErrorDto, type BatchTransactionResponseDto, BeanAccountsService, BeanBalancesService, BeanCommoditiesService, BeanTransactionsService, type BulkCreateRulesDto, type BulkCreateRulesResponseDto, type CacheControllerFlushCacheResponse, type CashFlowByCurrencyDto, type CashFlowResponseDto, type CloseAccountDto, type CommodityControllerBulkCreateData, type CommodityControllerBulkCreateResponse, type CommodityControllerCreateData, type CommodityControllerCreateResponse, type CommodityControllerDeleteData, type CommodityControllerDeleteResponse, type CommodityControllerFindAllData, type CommodityControllerFindAllResponse, type CommodityControllerFindOneData, type CommodityControllerFindOneResponse, type CommodityControllerGetOrCreateData, type CommodityControllerGetOrCreateResponse, type CommodityControllerUpdateData, type CommodityControllerUpdateResponse, type CommodityListResponseDto, type CommodityResponseDto, type ConfirmMatchDto, type ConvertedCashFlowDto, type ConvertedNetWorthDto, type CorrectTransactionDto, type CreateAccountDto, type CreateCommodityDto, type CreatePayeeDto, type CreatePayeeProfileDto, type CreatePlatformDto, type CreatePostingDto, type CreateRecurringRuleDto, type CreateRuleFromTransactionDto, type CreateTransactionDto, type CreateTransactionRuleDto, type CurrencyBalanceDto, type DashboardControllerGetAccountsData, type DashboardControllerGetAccountsResponse, type DashboardControllerGetCashFlowData, type DashboardControllerGetCashFlowResponse, type DashboardControllerGetNetWorthData, type DashboardControllerGetNetWorthResponse, type DecisionOptionDto, type DeleteOwnUserDto, type EnterNowDto, type ExchangeRateControllerGetExchangeRateData, type ExchangeRateControllerGetExchangeRateResponse, type ExchangeRateWarningDto, type ExpectedTransactionControllerConfirmMatchData, type ExpectedTransactionControllerConfirmMatchResponse, type ExpectedTransactionControllerEnterNowData, type ExpectedTransactionControllerEnterNowResponse, type ExpectedTransactionControllerFindAllData, type ExpectedTransactionControllerFindAllResponse, type ExpectedTransactionControllerFindOneData, type ExpectedTransactionControllerFindOneResponse, type ExpectedTransactionControllerFindOverdueData, type ExpectedTransactionControllerFindOverdueResponse, type ExpectedTransactionControllerSkipData, type ExpectedTransactionControllerSkipResponse, type ExpectedTransactionControllerUndoSkipData, type ExpectedTransactionControllerUndoSkipResponse, type ExpectedTransactionControllerUnmatchData, type ExpectedTransactionControllerUnmatchResponse, type ExpectedTransactionListResponseDto, type ExpectedTransactionResponseDto, type ExpectedTransactionRuleDto, type ExportControllerExportBeancountResponse, type ExportRulesResponseDto, type FileImportControllerIdentifyFileData, type FileImportControllerIdentifyFileResponse, type FileImportControllerImportBeancountData, type FileImportControllerImportBeancountResponse, type FileImportControllerImportFileData, type FileImportControllerImportFileResponse, type FileImportDto, type ForecastControllerGetForecastData, type ForecastControllerGetForecastResponse, type ForecastItemDto, type ForecastResponseDto, type GenerateSnapshotBody, type GenerateSnapshotResponse, type HealthControllerCheckDatabaseResponse, type HealthControllerCheckOpenBbResponse, type HealthControllerCheckRedisResponse, type HealthControllerGetCircuitBreakersHealthResponse, type HealthControllerGetHealthResponse, type HealthControllerGetMetricsResponse, type HealthControllerResetCircuitBreakerData, type HealthControllerResetCircuitBreakerResponse, HealthService, type IdentifyResultDto, type ImportErrorDto, type ImportResultDto, type ImporterConfigControllerGetConfigData, type ImporterConfigControllerGetConfigResponse, type ImporterConfigControllerResetConfigData, type ImporterConfigControllerResetConfigResponse, type ImporterConfigControllerUpdateConfigData, type ImporterConfigControllerUpdateConfigResponse, type ImporterConfigDataDto, type ImporterConfigDto, type InfoControllerGetInfoResponse, type MapperDefaultsDto, type MonthlyForecastDto, type MultiCurrencyBalanceResponseDto, type MultiCurrencyPointDto, type NetWorthByCurrencyDto, type NetWorthResponseDto, type NlpAccountConfirmationDataDto, type NlpAlternativePayeeDto, type NlpControllerClearSessionData, type NlpControllerClearSessionResponse, type NlpControllerGetSessionData, type NlpControllerGetSessionResponse, type NlpControllerProcessNaturalLanguageData, type NlpControllerProcessNaturalLanguageResponse, type NlpDefaultAccountsDto, type NlpDuplicateConfirmationDataDto, type NlpParsedDataDto, type NlpPayeeConfirmationDataDto, type NlpResponseDto, type NlpRuleConfirmationDataDto, type NlpSimilarityDto, type NlpSourceTransactionDto, type NlpSuggestedAccountDto, type NlpSuggestedAccountsDto, type NlpSuggestedPayeeDto, type NlpTargetTransactionDto, type NlpTransactionInfoDto, OpenAPI, type OpenAPIConfig, type ParserTelemetryReportDto, type PayeeAutocompleteResponseDto, type PayeeControllerAutocompleteData, type PayeeControllerAutocompleteResponse, type PayeeControllerCreateData, type PayeeControllerCreateResponse, type PayeeControllerDeleteData, type PayeeControllerDeleteResponse, type PayeeControllerFindAllData, type PayeeControllerFindAllResponse, type PayeeControllerFindOneData, type PayeeControllerFindOneResponse, type PayeeControllerGetTopPayeesData, type PayeeControllerGetTopPayeesResponse, type PayeeControllerUpdateData, type PayeeControllerUpdateResponse, type PayeeListResponseDto, type PayeeProfileAdminControllerCreateData, type PayeeProfileAdminControllerCreateResponse, type PayeeProfileAdminControllerDeleteData, type PayeeProfileAdminControllerDeleteResponse, type PayeeProfileAdminControllerFindAllData, type PayeeProfileAdminControllerFindAllResponse, type PayeeProfileAdminControllerFindOneData, type PayeeProfileAdminControllerFindOneResponse, type PayeeProfileAdminControllerUnverifyData, type PayeeProfileAdminControllerUnverifyResponse, type PayeeProfileAdminControllerUpdateData, type PayeeProfileAdminControllerUpdateResponse, type PayeeProfileAdminControllerVerifyData, type PayeeProfileAdminControllerVerifyResponse, type PayeeProfileListResponseDto, type PayeeProfileResponseDto, type PayeeResponseDto, type PayeeStatsResponseDto, type PlatformControllerCreateData, type PlatformControllerCreateResponse, type PlatformControllerDeleteData, type PlatformControllerDeleteResponse, type PlatformControllerFindAllResponse, type PlatformControllerGetPlatformListResponse, type PlatformControllerMatchPlatformsData, type PlatformControllerMatchPlatformsResponse, type PlatformControllerUpdateData, type PlatformControllerUpdateResponse, type PlatformGroupDto, type PortfolioTrendsResponseDto, type PostingDetailDto, type PostingResponseDto, type ProcessNlpDto, type PropertyControllerDeleteData, type PropertyControllerDeleteResponse, type PropertyControllerGetAllResponse, type PropertyControllerGetByKeyData, type PropertyControllerGetByKeyResponse, type PropertyControllerUpdateData, type PropertyControllerUpdateResponse, type ProviderSyncConfigDto, type ProviderSyncControllerGetSupportedProvidersData, type ProviderSyncControllerGetSupportedProvidersResponse, type ProviderSyncControllerIsProviderSupportedData, type ProviderSyncControllerIsProviderSupportedResponse, type ProviderSyncControllerSyncData, type ProviderSyncControllerSyncResponse, type ProviderSyncDto, type ProviderSyncResponseDto, ProviderSyncService, type RecurringMatchInfoDto, type RecurringRuleControllerCreateData, type RecurringRuleControllerCreateFromTransactionData, type RecurringRuleControllerCreateFromTransactionResponse, type RecurringRuleControllerCreateResponse, type RecurringRuleControllerDeleteData, type RecurringRuleControllerDeleteResponse, type RecurringRuleControllerFindAllData, type RecurringRuleControllerFindAllResponse, type RecurringRuleControllerFindOneData, type RecurringRuleControllerFindOneResponse, type RecurringRuleControllerGetWithStatsData, type RecurringRuleControllerGetWithStatsResponse, type RecurringRuleControllerUpdateData, type RecurringRuleControllerUpdateResponse, type RecurringRuleResponseDto, type RecurringRuleWithStatsResponseDto, type RecurringSuggestionDto, type RegionConfigDto, type RegionInfoDto, type RegionsMetadataResponseDto, type ReopenAccountDto, type ReportingControllerBackfillSnapshotsData, type ReportingControllerBackfillSnapshotsResponse, type ReportingControllerGenerateSnapshotData, type ReportingControllerGenerateSnapshotResponse, type ReportingControllerGetPortfolioTrendsData, type ReportingControllerGetPortfolioTrendsResponse, type ResolveResultDto, type ResolveReviewDto, type ReviewControllerBatchResolveData, type ReviewControllerBatchResolveResponse, type ReviewControllerFindAllData, type ReviewControllerFindAllResponse, type ReviewControllerFindOneData, type ReviewControllerFindOneResponse, type ReviewControllerGetStatsData, type ReviewControllerGetStatsResponse, type ReviewControllerResolveData, type ReviewControllerResolveResponse, type ReviewControllerUndoData, type ReviewControllerUndoResponse, type ReviewDetailDto, type ReviewItemPreviewDto, type ReviewListResponseDto, type ReviewStatsDto, type ReviewSummaryDto, type RuleStatisticsResponseDto, type SignupDto, type SupportedProvidersResponseDto, type TagSuggestionDto, type TagSuggestionsResponseDto, type TelemetryControllerReportTelemetryData, type TelemetryControllerReportTelemetryResponse, type TemplateMetadataDto, type TemplateMetadataResponseDto, type TestRuleDto, type TestRuleResponseDto, type TimeSeriesPointDto, type TransactionControllerCorrectData, type TransactionControllerCorrectResponse, type TransactionControllerCreateBatchData, type TransactionControllerCreateBatchResponse, type TransactionControllerCreateData, type TransactionControllerCreateResponse, type TransactionControllerDeleteData, type TransactionControllerDeleteResponse, type TransactionControllerGetDetailData, type TransactionControllerGetDetailResponse, type TransactionControllerListData, type TransactionControllerListResponse, type TransactionControllerSuggestTagsData, type TransactionControllerSuggestTagsResponse, type TransactionControllerUpdateData, type TransactionControllerUpdateResponse, type TransactionDetailDto, type TransactionListResponseDto, type TransactionResponseDto, type TransactionRuleControllerBulkCreateData, type TransactionRuleControllerBulkCreateResponse, type TransactionRuleControllerCreateData, type TransactionRuleControllerCreateResponse, type TransactionRuleControllerDeleteData, type TransactionRuleControllerDeleteResponse, type TransactionRuleControllerExportData, type TransactionRuleControllerExportResponse, type TransactionRuleControllerGetDetailData, type TransactionRuleControllerGetDetailResponse, type TransactionRuleControllerGetStatisticsData, type TransactionRuleControllerGetStatisticsResponse, type TransactionRuleControllerListData, type TransactionRuleControllerListResponse, type TransactionRuleControllerTestData, type TransactionRuleControllerTestResponse, type TransactionRuleControllerUpdateData, type TransactionRuleControllerUpdateResponse, type TransactionRuleControllerValidateData, type TransactionRuleControllerValidateResponse, type TransactionRuleListResponseDto, type TransactionRuleResponseDto, type TransactionSummaryDto, type TrendSummaryDto, type UndoResultDto, type UpdateAccountDto, type UpdateCommodityDto, type UpdateConfigDataDto, type UpdateImporterConfigDto, type UpdateMapperDefaultsDto, type UpdatePayeeDto, type UpdatePayeeProfileDto, type UpdatePlatformDto, type UpdatePropertyDto, type UpdateRecurringRuleDto, type UpdateTransactionDto, type UpdateTransactionRuleDto, type UpdateUserSettingDto, type UserControllerDeleteOwnUserData, type UserControllerDeleteOwnUserResponse, type UserControllerDeleteUserData, type UserControllerDeleteUserResponse, type UserControllerGetAllUserSettingsByPageData, type UserControllerGetAllUserSettingsByPageResponse, type UserControllerGetAssetLiabilitySummaryResponse, type UserControllerGetUserData, type UserControllerGetUserInfoData, type UserControllerGetUserInfoResponse, type UserControllerGetUserResponse, type UserControllerSignupUserData, type UserControllerSignupUserResponse, type UserControllerUpdateUserSettingData, type UserControllerUpdateUserSettingResponse, type ValidateRuleDto, type ValidateRuleResponseDto, type VersionedConfigDto, type action, type action2, type assetClass, type assetSubType, type bookingMethod, type branchType, type category, type colorScheme, type confidenceLevel, type conflictStrategy, type dataSource, type equitySubType, type flag, type flag2, type frequency, type importerId, type intent, type investmentAction, type learningSource, type liabilitySubType, type matchLogic, type paymentSource, type period, type source, type status, type status2, type status3, type status4, type suggestedFrequency, type type, type type2, type type3, type value, type viewMode };

package/dist/index.js

@@ -720,6 +720,33 @@ var BeanTransactionsService = class {
       }
     });
   }
+  /**
+   * Correct (supersede) a transaction
+   * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
+   * @param data The data for the request.
+   * @param data.id Original transaction ID to correct
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns TransactionDetailDto Corrected transaction created
+   * @throws ApiError
+   */
+  static transactionControllerCorrect(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/transactions/{id}/correct",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        404: "Original transaction not found",
+        409: "Original no longer ACTIVE (concurrent modification)",
+        422: "Pipeline validation failed (does not balance, invalid accounts)"
+      }
+    });
+  }
   /**
    * Suggest transaction tags
    * Returns distinct tags from the user ACTIVE transactions, sorted by usage, for autocomplete. Optional q performs a case-insensitive prefix match.

package/dist/index.mjs

@@ -688,6 +688,33 @@ var BeanTransactionsService = class {
       }
     });
   }
+  /**
+   * Correct (supersede) a transaction
+   * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
+   * @param data The data for the request.
+   * @param data.id Original transaction ID to correct
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns TransactionDetailDto Corrected transaction created
+   * @throws ApiError
+   */
+  static transactionControllerCorrect(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/transactions/{id}/correct",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        404: "Original transaction not found",
+        409: "Original no longer ACTIVE (concurrent modification)",
+        422: "Pipeline validation failed (does not balance, invalid accounts)"
+      }
+    });
+  }
   /**
    * Suggest transaction tags
    * Returns distinct tags from the user ACTIVE transactions, sorted by usage, for autocomplete. Optional q performs a case-insensitive prefix match.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firela/api-types",
-  "version": "0.0.0-canary.0327ab9e",
+  "version": "0.0.0-canary.074c27d4",
   "description": "TypeScript types generated from IGN OpenAPI specification",
   "license": "MIT",
   "author": "FireLa Team",

package/src/generated/schemas.gen.ts

@@ -841,6 +841,85 @@ export const $BatchTransactionResponseDto = {
   required: ['succeeded', 'failed']
 } as const;
 
+export const $CorrectTransactionDto = {
+  type: 'object',
+  properties: {
+    date: {
+      type: 'string',
+      description: 'Transaction date (ISO 8601 format)',
+      example: '2024-11-28'
+    },
+    flag: {
+      type: 'string',
+      description: 'Transaction flag: * (cleared), ! (pending)',
+      enum: ['*', '!'],
+      example: '*'
+    },
+    payee: {
+      type: 'string',
+      description: 'Payee name',
+      example: 'Whole Foods Market'
+    },
+    narration: {
+      type: 'string',
+      description: 'Transaction narration/description',
+      example: 'Grocery shopping'
+    },
+    tags: {
+      description: 'Transaction tags (without # prefix)',
+      example: ['vacation', 'personal'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    links: {
+      description: 'Transaction links (without ^ prefix)',
+      example: ['invoice-123'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    postings: {
+      description:
+        'Transaction postings (minimum 1, typically 2 for double-entry)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CreatePostingDto'
+      }
+    },
+    meta: {
+      type: 'object',
+      description: 'Transaction-level metadata',
+      example: {
+        invoice: '12345'
+      }
+    },
+    idempotencyKey: {
+      type: 'string',
+      description:
+        'Unique key for idempotent transaction creation. If provided, duplicate requests with the same key will return the existing transaction.',
+      example: 'import-2024-01-15-batch-001',
+      maxLength: 128
+    },
+    autoCreateAccounts: {
+      type: 'boolean',
+      description:
+        'Auto-create accounts if not found. When true, missing accounts will be automatically created. When false (default for API), missing accounts will cause a validation error. Set to true for quick entry scenarios where you want to create accounts on-the-fly.',
+      default: true,
+      example: true
+    },
+    correctionReason: {
+      type: 'string',
+      description: 'Reason for correcting/superseding the original transaction',
+      example: 'Wrong amount — corrected from receipt',
+      maxLength: 500
+    }
+  },
+  required: ['date', 'narration', 'postings']
+} as const;
+
 export const $PostingDetailDto = {
   type: 'object',
   properties: {
@@ -854,9 +933,9 @@ export const $PostingDetailDto = {
       description: 'Account ID',
       example: 'clh1234567890abcdef'
     },
-    accountName: {
+    account: {
       type: 'string',
-      description: 'Account name',
+      description: 'Fully-qualified Beancount account path',
       example: 'Assets:Bank:Checking'
     },
     units: {
@@ -905,7 +984,7 @@ export const $PostingDetailDto = {
       description: 'Posting metadata'
     }
   },
-  required: ['id', 'accountId', 'accountName']
+  required: ['id', 'accountId', 'account']
 } as const;
 
 export const $TransactionDetailDto = {
@@ -977,8 +1056,8 @@ export const $TransactionDetailDto = {
     },
     sourceType: {
       type: 'string',
-      description: 'Source type (how the transaction was created)',
-      enum: ['NLP', 'CSV', 'OCR', 'API']
+      description:
+        'Source type (free-form string from transaction metadata, e.g. import, api)'
     },
     sourcePlatform: {
       type: 'string',
@@ -1011,6 +1090,18 @@ export const $TransactionDetailDto = {
       type: 'string',
       description: 'Correction reason (if voided or superseded)',
       example: 'Duplicate entry'
+    },
+    supersededBy: {
+      type: 'string',
+      description:
+        'ID of the transaction that supersedes this one (set when status=SUPERSEDED)',
+      example: 'clh1234567890abcdef'
+    },
+    originalTxn: {
+      type: 'string',
+      description:
+        'ID of the transaction this one corrected/replaced (back-link on the replacement)',
+      example: 'clh1234567890abcdef'
     }
   },
   required: [
@@ -1235,8 +1326,8 @@ export const $TransactionSummaryDto = {
     },
     sourceType: {
       type: 'string',
-      description: 'Source type (NLP, CSV, OCR, API)',
-      enum: ['NLP', 'CSV', 'OCR', 'API']
+      description:
+        'Source type (free-form string from transaction metadata, e.g. import, api)'
     },
     sourcePlatform: {
       type: 'string',
@@ -1303,7 +1394,8 @@ export const $ReviewSummaryDto = {
     },
     sourceType: {
       type: 'string',
-      description: 'Source type (NLP, CSV, OCR, API)'
+      description:
+        'Source type (free-form string from transaction metadata, e.g. import, api)'
     },
     sourcePlatform: {
       type: 'string',
@@ -1413,7 +1505,20 @@ export const $DecisionOptionDto = {
   properties: {
     value: {
       type: 'string',
-      description: 'The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)'
+      description: 'The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)',
+      enum: [
+        'UPGRADE_REPLACE',
+        'LINK_KEEP_BOTH',
+        'IGNORE_NEW',
+        'CONFIRM_DIFFERENT',
+        'ACCEPT',
+        'REJECT',
+        'ACCEPT_AND_LEARN',
+        'CHOOSE_OTHER',
+        'CANCEL',
+        'FIX',
+        'IGNORE'
+      ]
     },
     labelKey: {
       type: 'string',
@@ -1488,7 +1593,8 @@ export const $ReviewDetailDto = {
     },
     sourceType: {
       type: 'string',
-      description: 'Source type (NLP, CSV, OCR, API)'
+      description:
+        'Source type (free-form string from transaction metadata, e.g. import, api)'
     },
     sourcePlatform: {
       type: 'string',
@@ -1568,7 +1674,20 @@ export const $ResolveReviewDto = {
     action: {
       type: 'string',
       description:
-        'Decision action. Available actions vary by review type: DUPLICATE: UPGRADE_REPLACE, LINK_KEEP_BOTH, IGNORE_NEW, CONFIRM_DIFFERENT | RULE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | PAYEE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | ACCOUNT_VALIDATION: ACCEPT, CHOOSE_OTHER, CANCEL | PIPELINE_ERROR: FIX, IGNORE, CANCEL',
+        'Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.',
+      enum: [
+        'UPGRADE_REPLACE',
+        'LINK_KEEP_BOTH',
+        'IGNORE_NEW',
+        'CONFIRM_DIFFERENT',
+        'ACCEPT',
+        'REJECT',
+        'ACCEPT_AND_LEARN',
+        'CHOOSE_OTHER',
+        'CANCEL',
+        'FIX',
+        'IGNORE'
+      ],
       example: 'ACCEPT'
     },
     data: {
@@ -1659,6 +1778,19 @@ export const $BatchResolveDto = {
     action: {
       type: 'string',
       description: 'Decision action to apply to all items',
+      enum: [
+        'UPGRADE_REPLACE',
+        'LINK_KEEP_BOTH',
+        'IGNORE_NEW',
+        'CONFIRM_DIFFERENT',
+        'ACCEPT',
+        'REJECT',
+        'ACCEPT_AND_LEARN',
+        'CHOOSE_OTHER',
+        'CANCEL',
+        'FIX',
+        'IGNORE'
+      ],
       example: 'ACCEPT'
     },
     data: {

package/src/generated/services.gen.ts

@@ -29,6 +29,8 @@ import type {
   TransactionControllerListResponse,
   TransactionControllerCreateBatchData,
   TransactionControllerCreateBatchResponse,
+  TransactionControllerCorrectData,
+  TransactionControllerCorrectResponse,
   TransactionControllerSuggestTagsData,
   TransactionControllerSuggestTagsResponse,
   TransactionControllerGetDetailData,
@@ -605,6 +607,36 @@ export class BeanTransactionsService {
     });
   }
 
+  /**
+   * Correct (supersede) a transaction
+   * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
+   * @param data The data for the request.
+   * @param data.id Original transaction ID to correct
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns TransactionDetailDto Corrected transaction created
+   * @throws ApiError
+   */
+  public static transactionControllerCorrect(
+    data: TransactionControllerCorrectData
+  ): CancelablePromise<TransactionControllerCorrectResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/transactions/{id}/correct',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        404: 'Original transaction not found',
+        409: 'Original no longer ACTIVE (concurrent modification)',
+        422: 'Pipeline validation failed (does not balance, invalid accounts)'
+      }
+    });
+  }
+
   /**
    * Suggest transaction tags
    * Returns distinct tags from the user ACTIVE transactions, sorted by usage, for autocomplete. Optional q performs a case-insensitive prefix match.

package/src/generated/types.gen.ts

@@ -561,6 +561,55 @@ export type BatchTransactionResponseDto = {
   failed: Array<BatchTransactionErrorDto>;
 };
 
+export type CorrectTransactionDto = {
+  /**
+   * Transaction date (ISO 8601 format)
+   */
+  date: string;
+  /**
+   * Transaction flag: * (cleared), ! (pending)
+   */
+  flag?: '*' | '!';
+  /**
+   * Payee name
+   */
+  payee?: string;
+  /**
+   * Transaction narration/description
+   */
+  narration: string;
+  /**
+   * Transaction tags (without # prefix)
+   */
+  tags?: Array<string>;
+  /**
+   * Transaction links (without ^ prefix)
+   */
+  links?: Array<string>;
+  /**
+   * Transaction postings (minimum 1, typically 2 for double-entry)
+   */
+  postings: Array<CreatePostingDto>;
+  /**
+   * Transaction-level metadata
+   */
+  meta?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Unique key for idempotent transaction creation. If provided, duplicate requests with the same key will return the existing transaction.
+   */
+  idempotencyKey?: string;
+  /**
+   * Auto-create accounts if not found. When true, missing accounts will be automatically created. When false (default for API), missing accounts will cause a validation error. Set to true for quick entry scenarios where you want to create accounts on-the-fly.
+   */
+  autoCreateAccounts?: boolean;
+  /**
+   * Reason for correcting/superseding the original transaction
+   */
+  correctionReason?: string;
+};
+
 export type PostingDetailDto = {
   /**
    * Posting ID
@@ -571,9 +620,9 @@ export type PostingDetailDto = {
    */
   accountId: string;
   /**
-   * Account name
+   * Fully-qualified Beancount account path
    */
-  accountName: string;
+  account: string;
   /**
    * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
    */
@@ -664,9 +713,9 @@ export type TransactionDetailDto = {
    */
   status: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
   /**
-   * Source type (how the transaction was created)
+   * Source type (free-form string from transaction metadata, e.g. import, api)
    */
-  sourceType?: 'NLP' | 'CSV' | 'OCR' | 'API';
+  sourceType?: string;
   /**
    * Source platform (e.g., alipay, wechat)
    */
@@ -691,6 +740,14 @@ export type TransactionDetailDto = {
    * Correction reason (if voided or superseded)
    */
   correctionReason?: string;
+  /**
+   * ID of the transaction that supersedes this one (set when status=SUPERSEDED)
+   */
+  supersededBy?: string;
+  /**
+   * ID of the transaction this one corrected/replaced (back-link on the replacement)
+   */
+  originalTxn?: string;
 };
 
 /**
@@ -709,11 +766,6 @@ export type flag2 =
  */
 export type status2 = 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
 
-/**
- * Source type (how the transaction was created)
- */
-export type sourceType = 'NLP' | 'CSV' | 'OCR' | 'API';
-
 export type TransactionListResponseDto = {
   /**
    * List of transactions
@@ -852,9 +904,9 @@ export type TransactionSummaryDto = {
    */
   accountName?: string;
   /**
-   * Source type (NLP, CSV, OCR, API)
+   * Source type (free-form string from transaction metadata, e.g. import, api)
    */
-  sourceType?: 'NLP' | 'CSV' | 'OCR' | 'API';
+  sourceType?: string;
   /**
    * Source platform (e.g., alipay, wechat)
    */
@@ -902,7 +954,7 @@ export type ReviewSummaryDto = {
    */
   matchReasons: Array<string>;
   /**
-   * Source type (NLP, CSV, OCR, API)
+   * Source type (free-form string from transaction metadata, e.g. import, api)
    */
   sourceType: string;
   /**
@@ -1000,7 +1052,18 @@ export type DecisionOptionDto = {
   /**
    * The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)
    */
-  value: string;
+  value:
+    | 'UPGRADE_REPLACE'
+    | 'LINK_KEEP_BOTH'
+    | 'IGNORE_NEW'
+    | 'CONFIRM_DIFFERENT'
+    | 'ACCEPT'
+    | 'REJECT'
+    | 'ACCEPT_AND_LEARN'
+    | 'CHOOSE_OTHER'
+    | 'CANCEL'
+    | 'FIX'
+    | 'IGNORE';
   /**
    * i18n message key for display label (e.g., review.payee.accept.label)
    */
@@ -1015,6 +1078,22 @@ export type DecisionOptionDto = {
   recommended?: boolean;
 };
 
+/**
+ * The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)
+ */
+export type value =
+  | 'UPGRADE_REPLACE'
+  | 'LINK_KEEP_BOTH'
+  | 'IGNORE_NEW'
+  | 'CONFIRM_DIFFERENT'
+  | 'ACCEPT'
+  | 'REJECT'
+  | 'ACCEPT_AND_LEARN'
+  | 'CHOOSE_OTHER'
+  | 'CANCEL'
+  | 'FIX'
+  | 'IGNORE';
+
 export type ReviewDetailDto = {
   /**
    * Review item ID
@@ -1056,7 +1135,7 @@ export type ReviewDetailDto = {
    */
   matchReasons: Array<string>;
   /**
-   * Source type (NLP, CSV, OCR, API)
+   * Source type (free-form string from transaction metadata, e.g. import, api)
    */
   sourceType: string;
   /**
@@ -1109,9 +1188,20 @@ export type ReviewDetailDto = {
 
 export type ResolveReviewDto = {
   /**
-   * Decision action. Available actions vary by review type: DUPLICATE: UPGRADE_REPLACE, LINK_KEEP_BOTH, IGNORE_NEW, CONFIRM_DIFFERENT | RULE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | PAYEE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | ACCOUNT_VALIDATION: ACCEPT, CHOOSE_OTHER, CANCEL | PIPELINE_ERROR: FIX, IGNORE, CANCEL
+   * Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.
    */
-  action: string;
+  action:
+    | 'UPGRADE_REPLACE'
+    | 'LINK_KEEP_BOTH'
+    | 'IGNORE_NEW'
+    | 'CONFIRM_DIFFERENT'
+    | 'ACCEPT'
+    | 'REJECT'
+    | 'ACCEPT_AND_LEARN'
+    | 'CHOOSE_OTHER'
+    | 'CANCEL'
+    | 'FIX'
+    | 'IGNORE';
   /**
    * Additional data for the decision (e.g., selected account ID)
    */
@@ -1120,6 +1210,22 @@ export type ResolveReviewDto = {
   };
 };
 
+/**
+ * Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.
+ */
+export type action =
+  | 'UPGRADE_REPLACE'
+  | 'LINK_KEEP_BOTH'
+  | 'IGNORE_NEW'
+  | 'CONFIRM_DIFFERENT'
+  | 'ACCEPT'
+  | 'REJECT'
+  | 'ACCEPT_AND_LEARN'
+  | 'CHOOSE_OTHER'
+  | 'CANCEL'
+  | 'FIX'
+  | 'IGNORE';
+
 export type ResolveResultDto = {
   /**
    * Whether resolution was successful
@@ -1176,7 +1282,18 @@ export type BatchResolveDto = {
   /**
    * Decision action to apply to all items
    */
-  action: string;
+  action:
+    | 'UPGRADE_REPLACE'
+    | 'LINK_KEEP_BOTH'
+    | 'IGNORE_NEW'
+    | 'CONFIRM_DIFFERENT'
+    | 'ACCEPT'
+    | 'REJECT'
+    | 'ACCEPT_AND_LEARN'
+    | 'CHOOSE_OTHER'
+    | 'CANCEL'
+    | 'FIX'
+    | 'IGNORE';
   /**
    * Additional data for the decision
    */
@@ -3839,7 +3956,7 @@ export type status4 = 'success' | 'pending' | 'error';
 /**
  * Action taken or requested
  */
-export type action =
+export type action2 =
   | 'created'
   | 'ask'
   | 'confirm'
@@ -4581,6 +4698,20 @@ export type TransactionControllerCreateBatchData = {
 export type TransactionControllerCreateBatchResponse =
   BatchTransactionResponseDto;
 
+export type TransactionControllerCorrectData = {
+  /**
+   * Original transaction ID to correct
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CorrectTransactionDto;
+};
+
+export type TransactionControllerCorrectResponse = TransactionDetailDto;
+
 export type TransactionControllerSuggestTagsData = {
   /**
    * Max suggestions (1-100, default 10)
@@ -6081,6 +6212,29 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/transactions/{id}/correct': {
+    post: {
+      req: TransactionControllerCorrectData;
+      res: {
+        /**
+         * Corrected transaction created
+         */
+        201: TransactionDetailDto;
+        /**
+         * Original transaction not found
+         */
+        404: ApiProblemResponseDto;
+        /**
+         * Original no longer ACTIVE (concurrent modification)
+         */
+        409: ApiProblemResponseDto;
+        /**
+         * Pipeline validation failed (does not balance, invalid accounts)
+         */
+        422: ApiProblemResponseDto;
+      };
+    };
+  };
   '/api/v1/{region}/bean/transactions/tags': {
     get: {
       req: TransactionControllerSuggestTagsData;