@vrplatform/api 1.3.1-stage.6437 → 1.3.1-stage.6449

package/build/main/generated/v1.d.ts

@@ -545,7 +545,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description Get bank records
+         * @description List bank records with optional reconciliation suggestions and bank-rule previews.
          *
          *     Required scope: bank-records:read
          */
@@ -608,7 +608,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description Get a bank record
+         * @description Get a bank record with optional reconciliation suggestions and bank-rule previews.
          *
          *     Required scope: bank-records:read
          */
@@ -6378,7 +6378,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description Transactions List
+         * @description List transactions. Each row includes the latest Ramp provider attempt and server-owned payment and recovery action capabilities with disabled reasons.
          *
          *     Required scope: transactions:read
          */
@@ -6676,13 +6676,13 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description Transactions List
+         * @description Get a transaction. Ramp payout reads include the latest immutable provider attempt and server-owned payment and recovery action capabilities with disabled reasons.
          *
          *     Required scope: transactions:read
          */
         get: operations["getTransactionsById"];
         /**
-         * @description Update a transaction by ID. Locks apply per line: lines whose journal entries are attached to an owner statement or fall into a books-closed month are locked while the remaining lines stay editable. Changing line account, assignment, listing, or reservation context can recompute a default or forced party. A bank-record match alone still permits deposit and expense description, line account, party, listing, reservation, and expense-markup changes. Amount, date, root bank account, line creation, and line deletion require unmatching first. Books-closed and statement locks still take precedence. A payout with a Requested, Processing, or Paid Ramp payment accepts only a description update until the provider attempt becomes terminal. See https://docs.vrplatform.app/guides/build/transactions#decision-table. For expense attachments, pass attachmentIds to replace the attached set. Omit attachmentIds to keep current attachments. Attachments are only supported for expense transactions. A uniqueRef already used by another team transaction returns a structured user error.
+         * @description Update a transaction by ID. Locks apply per line: lines whose journal entries are attached to an owner statement or fall into a books-closed month are locked while the remaining lines stay editable. Changing line account, assignment, listing, or reservation context can recompute a default or forced party. A bank-record match alone still permits deposit and expense description, line account, party, listing, reservation, and expense-markup changes. Amount, date, root bank account, line creation, and line deletion require unmatching first. Books-closed and statement locks still take precedence. After the first Ramp payment attempt, ordinary payout mutations accept only description updates. A status-only archive or unarchive additionally requires durable Ramp bill archive or verified no-bill recovery evidence. See https://docs.vrplatform.app/guides/build/transactions#decision-table. For expense attachments, pass attachmentIds to replace the attached set. Omit attachmentIds to keep current attachments. Attachments are only supported for expense transactions. A uniqueRef already used by another team transaction returns a structured user error.
          *
          *     Required scope: transactions:write
          */
@@ -6709,7 +6709,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * @description Record an expense as paid manually, or request a Ramp ACH payment for an expense or payout. Manual recording requires transactions:mark-paid. Ramp requests additionally require ach-payments:execute and a fundingAccountId whose imported source provides the exact Ramp entity and bank account. Every outbound bill Category account must also have a completed current Ramp chart-of-accounts push. A terminal provider failure can be retried against the existing transaction.
+         * @description Record an expense as paid manually, or request a Ramp ACH payment for an expense or payout. Manual recording requires transactions:mark-paid. Ramp requests additionally require ach-payments:execute and a fundingAccountId whose imported source provides the exact Ramp entity and bank account. Every outbound bill Category account must also have a completed current Ramp chart-of-accounts push. A payout can be submitted to Ramp only once; failed or returned payouts must be archived and recreated.
          *
          *     Required scope: transactions:mark-paid
          */
@@ -6752,7 +6752,8 @@ export interface paths {
         put?: never;
         post?: never;
         /**
-         * @description Unlink a never-submitted or terminal Ramp payment attempt from a transaction. This requires transactions:mark-paid and ach-payments:execute. Submitted requested, processing, and paid payments cannot be unlinked. Confirm any post-initiation cancellation debit or refund before removing the link and requesting another payment.
+         * @deprecated
+         * @description Deprecated compatibility endpoint. Provider payment history is permanent and cannot be unlinked.
          *
          *     Required scope: transactions:mark-paid, ach-payments:execute
          */
@@ -6762,6 +6763,27 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/transactions/{id}/provider-payments/{providerPaymentId}/archive": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * @description Archive a failed, returned, or canceled Ramp bill and then archive the payout accounting. Paid payouts cannot be archived. The provider mutation completes before journal entries are made inactive.
+         *
+         *     Required scope: transactions:write, ach-payments:execute
+         */
+        post: operations["postTransactionsByIdProviderPaymentsByProviderPaymentIdArchive"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/transactions/{id}/provider-payments/{providerPaymentId}/cancel": {
         parameters: {
             query?: never;
@@ -6772,7 +6794,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * @description Request cancellation of a requested or processing Ramp payment. Ramp archives the bill and remains authoritative about whether cancellation is still possible. This does not unlink the payment or change payout accounting. An initiated payment cannot be retried until its funds are confirmed and its link is deliberately removed.
+         * @description Request cancellation of a requested or processing Ramp payment. Ramp is authoritative about cancellation eligibility. archivePayout=true first validates local accounting, then archives the payout only after the Ramp bill archive is durable. archivePayout=false stops money movement without changing payout accounting.
          *
          *     Required scope: transactions:mark-paid, ach-payments:execute
          */
@@ -10615,6 +10637,8 @@ export interface operations {
                             /** @description Expense attachment IDs returned as attachmentId by POST /transactions/attachments after PUT to uploadUrl succeeds. Only expense transactions support attachments. Omit to leave existing attachments unchanged on update; send an array to replace the attached set. */
                             attachmentIds?: string[] | null;
                             recurringTemplateId?: string | null;
+                            /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                            recreatedFromTransactionId?: string | null;
                             matchBankAccountLast4?: string | null;
                             id: string;
                             shortRef?: string | null;
@@ -14923,7 +14947,7 @@ export interface operations {
                 updatedFrom?: string;
                 /** @description Timestamp string with date, time, milliseconds, and timezone. */
                 updatedTo?: string;
-                entityType?: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction";
+                entityType?: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription";
                 entityId?: string;
                 actionId?: string;
                 actionCode?: string;
@@ -14935,7 +14959,7 @@ export interface operations {
                 /** @description Whether any public entity or journal-entry change exists */
                 hasChanges?: boolean;
                 /** @description Public subject participating in entityChanges */
-                changedEntityType?: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction" | "paymentLine";
+                changedEntityType?: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription" | "paymentLine";
                 /** @description Exact public registry path for changedEntityType */
                 changedPath?: string;
             };
@@ -14997,7 +15021,7 @@ export interface operations {
                             };
                             rootEntity: {
                                 /** @enum {string} */
-                                type: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction";
+                                type: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription";
                                 /** Format: uuid */
                                 id: string;
                                 uniqueRef: string | null;
@@ -15006,7 +15030,7 @@ export interface operations {
                             entityChanges: {
                                 entity: {
                                     /** @enum {string} */
-                                    type: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction" | "paymentLine";
+                                    type: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription" | "paymentLine";
                                     /** Format: uuid */
                                     id: string;
                                     uniqueRef: string | null;
@@ -15487,7 +15511,7 @@ export interface operations {
                         };
                         rootEntity: {
                             /** @enum {string} */
-                            type: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction";
+                            type: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription";
                             /** Format: uuid */
                             id: string;
                             uniqueRef: string | null;
@@ -15496,7 +15520,7 @@ export interface operations {
                         entityChanges: {
                             entity: {
                                 /** @enum {string} */
-                                type: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction" | "paymentLine";
+                                type: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription" | "paymentLine";
                                 /** Format: uuid */
                                 id: string;
                                 uniqueRef: string | null;
@@ -15750,7 +15774,7 @@ export interface operations {
                                 causedBy: {
                                     entity: {
                                         /** @enum {string} */
-                                        type: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction" | "paymentLine" | "journalEntry";
+                                        type: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription" | "paymentLine" | "journalEntry";
                                         /** Format: uuid */
                                         id: string;
                                     };
@@ -17130,6 +17154,7 @@ export interface operations {
                 reconcileStatus?: "unpaid" | "underpaid" | "overpaid" | "paid";
                 matchedByBankRule?: boolean;
                 includeBalanceRecords?: boolean;
+                /** @description Include bank-rule suggestions; defaults to true when includeMatchingTransactions is set */
                 includeMatchingRules?: boolean;
                 /** @description Include matching transactions, optionally with max days offset */
                 includeMatchingTransactions?: string;
@@ -17245,7 +17270,37 @@ export interface operations {
                                 recurringTemplate?: {
                                     id: string;
                                 } | null;
+                                /** @description Absolute difference in days from the bank record date */
                                 dateOffset: number;
+                                /** @description Structured explanation for the transaction suggestion */
+                                matchDetails: {
+                                    /** @description Whether another candidate has the same date offset */
+                                    ambiguous: boolean;
+                                    /** @description Candidate amount minus bank record amount, in cents; exact matches return zero */
+                                    amountDifference: number;
+                                    /** @description Transaction date used to evaluate the bank-record date window */
+                                    matchingDate: string;
+                                    /** @description Maximum eligible difference in days */
+                                    maxDateOffset: number;
+                                    /** @description Typed criteria satisfied by this candidate */
+                                    reasons: ("exactAmount" | "sameBankAccount" | "bankAccountAssignedOnMatch" | "dateWithinWindow")[];
+                                };
+                                /** @description Unique listings referenced by the transaction lines */
+                                listings: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    name: string;
+                                    uniqueRef?: string | null;
+                                    shortRef?: string | null;
+                                }[];
+                                /** @description Unique reservations referenced by the transaction lines */
+                                reservations: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    confirmationCode?: string | null;
+                                    uniqueRef?: string | null;
+                                    shortRef?: string | null;
+                                }[];
                             }[] | null;
                             matchingRules?: {
                                 rule: {
@@ -17329,9 +17384,45 @@ export interface operations {
                                         connectionId?: string | null;
                                         sourceId?: string | null;
                                         recurringTemplateId?: string | null;
+                                        /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                                        recreatedFromTransactionId?: string | null;
                                         matchBankAccountLast4?: string | null;
                                     };
                                 };
+                                /** @description Structured explanation for the bank-rule suggestion */
+                                matchDetails: {
+                                    /** @description Whether another matching rule has the same mode and priority */
+                                    ambiguous: boolean;
+                                    /** @description Whether the rule is limited to selected bank accounts */
+                                    hasAccountScope: boolean;
+                                    /** @description Whether the bank record satisfies the rule account scope */
+                                    accountMatches: boolean;
+                                    /** @description Whether deposit or expense direction matches the record */
+                                    directionMatches: boolean;
+                                    /**
+                                     * @description Whether all or any configured conditions must match
+                                     * @enum {string}
+                                     */
+                                    matchMode: "all" | "any";
+                                    /** @description Evaluation result for every configured condition */
+                                    conditions: {
+                                        condition: {
+                                            /** @constant */
+                                            type: "description";
+                                            /** @enum {string} */
+                                            operator: "contains" | "equals" | "startsWith";
+                                            value: string;
+                                        } | {
+                                            /** @constant */
+                                            type: "amount";
+                                            /** @enum {string} */
+                                            operator: ">" | ">=" | "=" | "<" | "<=";
+                                            centValue: number;
+                                        };
+                                        /** @description Whether this individual condition matches */
+                                        matches: boolean;
+                                    }[];
+                                };
                             }[] | null;
                             currency?: string | null;
                         }[];
@@ -17891,6 +17982,7 @@ export interface operations {
                 reconcileStatus?: "unpaid" | "underpaid" | "overpaid" | "paid";
                 matchedByBankRule?: boolean;
                 includeBalanceRecords?: boolean;
+                /** @description Include bank-rule suggestions; defaults to true when includeMatchingTransactions is set */
                 includeMatchingRules?: boolean;
                 /** @description Include matching transactions, optionally with max days offset */
                 includeMatchingTransactions?: string;
@@ -18146,6 +18238,7 @@ export interface operations {
     getBankRecordsById: {
         parameters: {
             query?: {
+                /** @description Include bank-rule suggestions; defaults to true when includeMatchingTransactions is set */
                 includeMatchingRules?: boolean;
                 /** @description Include matching transactions, optionally with max days offset */
                 includeMatchingTransactions?: string;
@@ -18255,7 +18348,37 @@ export interface operations {
                             recurringTemplate?: {
                                 id: string;
                             } | null;
+                            /** @description Absolute difference in days from the bank record date */
                             dateOffset: number;
+                            /** @description Structured explanation for the transaction suggestion */
+                            matchDetails: {
+                                /** @description Whether another candidate has the same date offset */
+                                ambiguous: boolean;
+                                /** @description Candidate amount minus bank record amount, in cents; exact matches return zero */
+                                amountDifference: number;
+                                /** @description Transaction date used to evaluate the bank-record date window */
+                                matchingDate: string;
+                                /** @description Maximum eligible difference in days */
+                                maxDateOffset: number;
+                                /** @description Typed criteria satisfied by this candidate */
+                                reasons: ("exactAmount" | "sameBankAccount" | "bankAccountAssignedOnMatch" | "dateWithinWindow")[];
+                            };
+                            /** @description Unique listings referenced by the transaction lines */
+                            listings: {
+                                /** Format: uuid */
+                                id: string;
+                                name: string;
+                                uniqueRef?: string | null;
+                                shortRef?: string | null;
+                            }[];
+                            /** @description Unique reservations referenced by the transaction lines */
+                            reservations: {
+                                /** Format: uuid */
+                                id: string;
+                                confirmationCode?: string | null;
+                                uniqueRef?: string | null;
+                                shortRef?: string | null;
+                            }[];
                         }[] | null;
                         matchingRules?: {
                             rule: {
@@ -18339,9 +18462,45 @@ export interface operations {
                                     connectionId?: string | null;
                                     sourceId?: string | null;
                                     recurringTemplateId?: string | null;
+                                    /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                                    recreatedFromTransactionId?: string | null;
                                     matchBankAccountLast4?: string | null;
                                 };
                             };
+                            /** @description Structured explanation for the bank-rule suggestion */
+                            matchDetails: {
+                                /** @description Whether another matching rule has the same mode and priority */
+                                ambiguous: boolean;
+                                /** @description Whether the rule is limited to selected bank accounts */
+                                hasAccountScope: boolean;
+                                /** @description Whether the bank record satisfies the rule account scope */
+                                accountMatches: boolean;
+                                /** @description Whether deposit or expense direction matches the record */
+                                directionMatches: boolean;
+                                /**
+                                 * @description Whether all or any configured conditions must match
+                                 * @enum {string}
+                                 */
+                                matchMode: "all" | "any";
+                                /** @description Evaluation result for every configured condition */
+                                conditions: {
+                                    condition: {
+                                        /** @constant */
+                                        type: "description";
+                                        /** @enum {string} */
+                                        operator: "contains" | "equals" | "startsWith";
+                                        value: string;
+                                    } | {
+                                        /** @constant */
+                                        type: "amount";
+                                        /** @enum {string} */
+                                        operator: ">" | ">=" | "=" | "<" | "<=";
+                                        centValue: number;
+                                    };
+                                    /** @description Whether this individual condition matches */
+                                    matches: boolean;
+                                }[];
+                            };
                         }[] | null;
                         currency?: string | null;
                     };
@@ -19992,6 +20151,8 @@ export interface operations {
                                 connectionId?: string | null;
                                 sourceId?: string | null;
                                 recurringTemplateId?: string | null;
+                                /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                                recreatedFromTransactionId?: string | null;
                                 matchBankAccountLast4?: string | null;
                             };
                         }[];
@@ -21339,6 +21500,8 @@ export interface operations {
                                     connectionId?: string | null;
                                     sourceId?: string | null;
                                     recurringTemplateId?: string | null;
+                                    /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                                    recreatedFromTransactionId?: string | null;
                                     matchBankAccountLast4?: string | null;
                                 };
                             } | null;
@@ -34512,6 +34675,8 @@ export interface operations {
                                 } | null;
                                 sourceId?: string | null;
                                 recurringTemplateId?: string | null;
+                                /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                                recreatedFromTransactionId?: string | null;
                                 matchBankAccountLast4?: string | null;
                                 id?: string;
                             };
@@ -34724,6 +34889,8 @@ export interface operations {
                                 } | null;
                                 sourceId?: string | null;
                                 recurringTemplateId?: string | null;
+                                /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                                recreatedFromTransactionId?: string | null;
                                 matchBankAccountLast4?: string | null;
                                 id?: string;
                             };
@@ -78162,7 +78329,7 @@ export interface operations {
                 updatedFrom?: string;
                 /** @description Timestamp string with date, time, milliseconds, and timezone. */
                 updatedTo?: string;
-                entityType?: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction";
+                entityType?: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription";
                 entityId?: string;
                 actionId?: string;
                 actionCode?: string;
@@ -78174,7 +78341,7 @@ export interface operations {
                 /** @description Whether any public entity or journal-entry change exists */
                 hasChanges?: boolean;
                 /** @description Public subject participating in entityChanges */
-                changedEntityType?: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction" | "paymentLine";
+                changedEntityType?: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription" | "paymentLine";
                 /** @description Exact public registry path for changedEntityType */
                 changedPath?: string;
                 teamId?: string;
@@ -78240,7 +78407,7 @@ export interface operations {
                             };
                             rootEntity: {
                                 /** @enum {string} */
-                                type: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction";
+                                type: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription";
                                 /** Format: uuid */
                                 id: string;
                                 uniqueRef: string | null;
@@ -78249,7 +78416,7 @@ export interface operations {
                             entityChanges: {
                                 entity: {
                                     /** @enum {string} */
-                                    type: "account" | "accountConnection" | "bankRecord" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "recurringFee" | "reservation" | "transaction" | "paymentLine";
+                                    type: "account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription" | "paymentLine";
                                     /** Format: uuid */
                                     id: string;
                                     uniqueRef: string | null;
@@ -112856,6 +113023,10 @@ export interface operations {
                                     status: "requested" | "processing" | "paid" | "failed" | "returned" | "canceled";
                                     /** @description Ramp bill status summary returned by the provider. */
                                     providerStatus: string | null;
+                                    /** @description Ramp Transfer API identifier when a transfer was observed. */
+                                    providerTransferId: string | null;
+                                    /** @description Raw Ramp Transfer API status used for lifecycle evidence. */
+                                    providerTransferStatus: string | null;
                                     externalRef: string | null;
                                     /** @description Customer-friendly Ramp payment reference. */
                                     paymentReference: string | null;
@@ -112869,6 +113040,8 @@ export interface operations {
                                     initiatedAt: string | null;
                                     /** @description Date and time Ramp marks the bill payment completed. */
                                     completedAt: string | null;
+                                    /** @description Date and time VRPlatform confirmed the Ramp bill archive. */
+                                    billArchivedAt: string | null;
                                     failureReason: string | null;
                                     attemptId: string;
                                     attempt: number;
@@ -115092,6 +115265,10 @@ export interface operations {
                                     status: "requested" | "processing" | "paid" | "failed" | "returned" | "canceled";
                                     /** @description Ramp bill status summary returned by the provider. */
                                     providerStatus: string | null;
+                                    /** @description Ramp Transfer API identifier when a transfer was observed. */
+                                    providerTransferId: string | null;
+                                    /** @description Raw Ramp Transfer API status used for lifecycle evidence. */
+                                    providerTransferStatus: string | null;
                                     externalRef: string | null;
                                     /** @description Customer-friendly Ramp payment reference. */
                                     paymentReference: string | null;
@@ -115105,6 +115282,8 @@ export interface operations {
                                     initiatedAt: string | null;
                                     /** @description Date and time Ramp marks the bill payment completed. */
                                     completedAt: string | null;
+                                    /** @description Date and time VRPlatform confirmed the Ramp bill archive. */
+                                    billArchivedAt: string | null;
                                     failureReason: string | null;
                                     attemptId: string;
                                     attempt: number;
@@ -120283,6 +120462,8 @@ export interface operations {
                         /** @description Expense attachment IDs returned as attachmentId by POST /transactions/attachments after PUT to uploadUrl succeeds. Only expense transactions support attachments. Omit to leave existing attachments unchanged on update; send an array to replace the attached set. */
                         attachmentIds?: string[] | null;
                         recurringTemplateId?: string | null;
+                        /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                        recreatedFromTransactionId?: string | null;
                         matchBankAccountLast4?: string | null;
                         id: string;
                         shortRef?: string | null;
@@ -122436,6 +122617,10 @@ export interface operations {
                                 status: "requested" | "processing" | "paid" | "failed" | "returned" | "canceled";
                                 /** @description Ramp bill status summary returned by the provider. */
                                 providerStatus: string | null;
+                                /** @description Ramp Transfer API identifier when a transfer was observed. */
+                                providerTransferId: string | null;
+                                /** @description Raw Ramp Transfer API status used for lifecycle evidence. */
+                                providerTransferStatus: string | null;
                                 externalRef: string | null;
                                 /** @description Customer-friendly Ramp payment reference. */
                                 paymentReference: string | null;
@@ -122449,6 +122634,8 @@ export interface operations {
                                 initiatedAt: string | null;
                                 /** @description Date and time Ramp marks the bill payment completed. */
                                 completedAt: string | null;
+                                /** @description Date and time VRPlatform confirmed the Ramp bill archive. */
+                                billArchivedAt: string | null;
                                 failureReason: string | null;
                                 attemptId: string;
                                 attempt: number;
@@ -138462,6 +138649,8 @@ export interface operations {
                             /** @description Expense attachment IDs returned as attachmentId by POST /transactions/attachments after PUT to uploadUrl succeeds. Only expense transactions support attachments. Omit to leave existing attachments unchanged on update; send an array to replace the attached set. */
                             attachmentIds?: string[] | null;
                             recurringTemplateId?: string | null;
+                            /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                            recreatedFromTransactionId?: string | null;
                             matchBankAccountLast4?: string | null;
                             id: string;
                             shortRef?: string | null;
@@ -138631,6 +138820,10 @@ export interface operations {
                                 status: "requested" | "processing" | "paid" | "failed" | "returned" | "canceled";
                                 /** @description Ramp bill status summary returned by the provider. */
                                 providerStatus: string | null;
+                                /** @description Ramp Transfer API identifier when a transfer was observed. */
+                                providerTransferId: string | null;
+                                /** @description Raw Ramp Transfer API status used for lifecycle evidence. */
+                                providerTransferStatus: string | null;
                                 externalRef: string | null;
                                 /** @description Customer-friendly Ramp payment reference. */
                                 paymentReference: string | null;
@@ -138644,6 +138837,8 @@ export interface operations {
                                 initiatedAt: string | null;
                                 /** @description Date and time Ramp marks the bill payment completed. */
                                 completedAt: string | null;
+                                /** @description Date and time VRPlatform confirmed the Ramp bill archive. */
+                                billArchivedAt: string | null;
                                 failureReason: string | null;
                                 attemptId: string;
                                 attempt: number;
@@ -138660,6 +138855,51 @@ export interface operations {
                                  */
                                 updatedAt: string;
                             } | null;
+                            /** @description Server-owned Ramp payout recovery capabilities. Permissions remain independently enforced. */
+                            providerPaymentActions: {
+                                pay: {
+                                    /** @description Whether current provider and accounting state allows the action. */
+                                    available: boolean;
+                                    /** @description Static disabled reason, or null when the action is available. */
+                                    reason: string | null;
+                                };
+                                cancel: {
+                                    /** @description Whether current provider and accounting state allows the action. */
+                                    available: boolean;
+                                    /** @description Static disabled reason, or null when the action is available. */
+                                    reason: string | null;
+                                };
+                                cancelAndArchive: {
+                                    /** @description Whether current provider and accounting state allows the action. */
+                                    available: boolean;
+                                    /** @description Static disabled reason, or null when the action is available. */
+                                    reason: string | null;
+                                };
+                                cancelAndRecreate: {
+                                    /** @description Whether current provider and accounting state allows the action. */
+                                    available: boolean;
+                                    /** @description Static disabled reason, or null when the action is available. */
+                                    reason: string | null;
+                                };
+                                archive: {
+                                    /** @description Whether current provider and accounting state allows the action. */
+                                    available: boolean;
+                                    /** @description Static disabled reason, or null when the action is available. */
+                                    reason: string | null;
+                                };
+                                archiveAndRecreate: {
+                                    /** @description Whether current provider and accounting state allows the action. */
+                                    available: boolean;
+                                    /** @description Static disabled reason, or null when the action is available. */
+                                    reason: string | null;
+                                };
+                                unarchive: {
+                                    /** @description Whether current provider and accounting state allows the action. */
+                                    available: boolean;
+                                    /** @description Static disabled reason, or null when the action is available. */
+                                    reason: string | null;
+                                };
+                            };
                         }[];
                         pagination: {
                             /** @default 100 */
@@ -139010,6 +139250,8 @@ export interface operations {
                     connectionId?: string | null;
                     sourceId?: string | null;
                     recurringTemplateId?: string | null;
+                    /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                    recreatedFromTransactionId?: string | null;
                     matchBankAccountLast4?: string | null;
                 };
             };
@@ -139159,6 +139401,8 @@ export interface operations {
                         /** @description Expense attachment IDs returned as attachmentId by POST /transactions/attachments after PUT to uploadUrl succeeds. Only expense transactions support attachments. Omit to leave existing attachments unchanged on update; send an array to replace the attached set. */
                         attachmentIds?: string[] | null;
                         recurringTemplateId?: string | null;
+                        /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                        recreatedFromTransactionId?: string | null;
                         matchBankAccountLast4?: string | null;
                         id: string;
                         shortRef?: string | null;
@@ -140940,6 +141184,8 @@ export interface operations {
                         } | null;
                         sourceId?: string | null;
                         recurringTemplateId?: string | null;
+                        /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                        recreatedFromTransactionId?: string | null;
                         matchBankAccountLast4?: string | null;
                         id?: string;
                     }[];
@@ -144519,6 +144765,8 @@ export interface operations {
                             /** @description Expense attachment IDs returned as attachmentId by POST /transactions/attachments after PUT to uploadUrl succeeds. Only expense transactions support attachments. Omit to leave existing attachments unchanged on update; send an array to replace the attached set. */
                             attachmentIds?: string[] | null;
                             recurringTemplateId?: string | null;
+                            /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                            recreatedFromTransactionId?: string | null;
                             matchBankAccountLast4?: string | null;
                             id: string;
                             shortRef?: string | null;
@@ -145060,6 +145308,8 @@ export interface operations {
                         /** @description Expense attachment IDs returned as attachmentId by POST /transactions/attachments after PUT to uploadUrl succeeds. Only expense transactions support attachments. Omit to leave existing attachments unchanged on update; send an array to replace the attached set. */
                         attachmentIds?: string[] | null;
                         recurringTemplateId?: string | null;
+                        /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                        recreatedFromTransactionId?: string | null;
                         matchBankAccountLast4?: string | null;
                         id: string;
                         shortRef?: string | null;
@@ -145229,6 +145479,10 @@ export interface operations {
                             status: "requested" | "processing" | "paid" | "failed" | "returned" | "canceled";
                             /** @description Ramp bill status summary returned by the provider. */
                             providerStatus: string | null;
+                            /** @description Ramp Transfer API identifier when a transfer was observed. */
+                            providerTransferId: string | null;
+                            /** @description Raw Ramp Transfer API status used for lifecycle evidence. */
+                            providerTransferStatus: string | null;
                             externalRef: string | null;
                             /** @description Customer-friendly Ramp payment reference. */
                             paymentReference: string | null;
@@ -145242,6 +145496,8 @@ export interface operations {
                             initiatedAt: string | null;
                             /** @description Date and time Ramp marks the bill payment completed. */
                             completedAt: string | null;
+                            /** @description Date and time VRPlatform confirmed the Ramp bill archive. */
+                            billArchivedAt: string | null;
                             failureReason: string | null;
                             attemptId: string;
                             attempt: number;
@@ -145258,6 +145514,51 @@ export interface operations {
                              */
                             updatedAt: string;
                         } | null;
+                        /** @description Server-owned Ramp payout recovery capabilities. Permissions remain independently enforced. */
+                        providerPaymentActions: {
+                            pay: {
+                                /** @description Whether current provider and accounting state allows the action. */
+                                available: boolean;
+                                /** @description Static disabled reason, or null when the action is available. */
+                                reason: string | null;
+                            };
+                            cancel: {
+                                /** @description Whether current provider and accounting state allows the action. */
+                                available: boolean;
+                                /** @description Static disabled reason, or null when the action is available. */
+                                reason: string | null;
+                            };
+                            cancelAndArchive: {
+                                /** @description Whether current provider and accounting state allows the action. */
+                                available: boolean;
+                                /** @description Static disabled reason, or null when the action is available. */
+                                reason: string | null;
+                            };
+                            cancelAndRecreate: {
+                                /** @description Whether current provider and accounting state allows the action. */
+                                available: boolean;
+                                /** @description Static disabled reason, or null when the action is available. */
+                                reason: string | null;
+                            };
+                            archive: {
+                                /** @description Whether current provider and accounting state allows the action. */
+                                available: boolean;
+                                /** @description Static disabled reason, or null when the action is available. */
+                                reason: string | null;
+                            };
+                            archiveAndRecreate: {
+                                /** @description Whether current provider and accounting state allows the action. */
+                                available: boolean;
+                                /** @description Static disabled reason, or null when the action is available. */
+                                reason: string | null;
+                            };
+                            unarchive: {
+                                /** @description Whether current provider and accounting state allows the action. */
+                                available: boolean;
+                                /** @description Static disabled reason, or null when the action is available. */
+                                reason: string | null;
+                            };
+                        };
                     };
                 };
             };
@@ -145821,6 +146122,8 @@ export interface operations {
                         /** @description Expense attachment IDs returned as attachmentId by POST /transactions/attachments after PUT to uploadUrl succeeds. Only expense transactions support attachments. Omit to leave existing attachments unchanged on update; send an array to replace the attached set. */
                         attachmentIds?: string[] | null;
                         recurringTemplateId?: string | null;
+                        /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                        recreatedFromTransactionId?: string | null;
                         matchBankAccountLast4?: string | null;
                         id: string;
                         shortRef?: string | null;
@@ -146508,6 +146811,10 @@ export interface operations {
                             status: "requested" | "processing" | "paid" | "failed" | "returned" | "canceled";
                             /** @description Ramp bill status summary returned by the provider. */
                             providerStatus: string | null;
+                            /** @description Ramp Transfer API identifier when a transfer was observed. */
+                            providerTransferId: string | null;
+                            /** @description Raw Ramp Transfer API status used for lifecycle evidence. */
+                            providerTransferStatus: string | null;
                             externalRef: string | null;
                             /** @description Customer-friendly Ramp payment reference. */
                             paymentReference: string | null;
@@ -146521,6 +146828,8 @@ export interface operations {
                             initiatedAt: string | null;
                             /** @description Date and time Ramp marks the bill payment completed. */
                             completedAt: string | null;
+                            /** @description Date and time VRPlatform confirmed the Ramp bill archive. */
+                            billArchivedAt: string | null;
                             failureReason: string | null;
                             attemptId: string;
                             attempt: number;
@@ -146799,6 +147108,10 @@ export interface operations {
                             status: "requested" | "processing" | "paid" | "failed" | "returned" | "canceled";
                             /** @description Ramp bill status summary returned by the provider. */
                             providerStatus: string | null;
+                            /** @description Ramp Transfer API identifier when a transfer was observed. */
+                            providerTransferId: string | null;
+                            /** @description Raw Ramp Transfer API status used for lifecycle evidence. */
+                            providerTransferStatus: string | null;
                             externalRef: string | null;
                             /** @description Customer-friendly Ramp payment reference. */
                             paymentReference: string | null;
@@ -146812,6 +147125,8 @@ export interface operations {
                             initiatedAt: string | null;
                             /** @description Date and time Ramp marks the bill payment completed. */
                             completedAt: string | null;
+                            /** @description Date and time VRPlatform confirmed the Ramp bill archive. */
+                            billArchivedAt: string | null;
                             failureReason: string | null;
                             attemptId: string;
                             attempt: number;
@@ -147311,7 +147626,7 @@ export interface operations {
             };
         };
     };
-    postTransactionsByIdProviderPaymentsByProviderPaymentIdCancel: {
+    postTransactionsByIdProviderPaymentsByProviderPaymentIdArchive: {
         parameters: {
             query?: never;
             header?: never;
@@ -147338,6 +147653,273 @@ export interface operations {
                         providerPaymentId: string;
                         /** Format: uuid */
                         syncId: string;
+                        /** @enum {string} */
+                        operation: "cancel" | "archive";
+                        archivePayout: boolean;
+                        /** @constant */
+                        status: "requested";
+                    };
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+            /** @description Gone */
+            410: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+            /** @description Unprocessable content */
+            422: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+            /** @description Service unavailable */
+            503: {
+                headers: {
+                    /** @description Seconds to wait when retryable=true and the server supplies a delay. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: string;
+                        message: string;
+                        links?: {
+                            docs: string;
+                            schema: string;
+                        };
+                        issues?: {
+                            message: string;
+                            path?: (string | number)[];
+                            schema?: string;
+                        }[];
+                        retryable?: boolean;
+                        context?: unknown;
+                    };
+                };
+            };
+        };
+    };
+    postTransactionsByIdProviderPaymentsByProviderPaymentIdCancel: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+                providerPaymentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    archivePayout: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Successful response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        providerPaymentId: string;
+                        /** Format: uuid */
+                        syncId: string;
+                        /** @enum {string} */
+                        operation: "cancel" | "archive";
+                        archivePayout: boolean;
                         /** @constant */
                         status: "requested";
                     };
@@ -147764,6 +148346,8 @@ export interface operations {
                         /** @description Expense attachment IDs returned as attachmentId by POST /transactions/attachments after PUT to uploadUrl succeeds. Only expense transactions support attachments. Omit to leave existing attachments unchanged on update; send an array to replace the attached set. */
                         attachmentIds?: string[] | null;
                         recurringTemplateId?: string | null;
+                        /** @description Archived payout replaced by this payout. The source and every other payout in its replacement chain must remain inactive. */
+                        recreatedFromTransactionId?: string | null;
                         matchBankAccountLast4?: string | null;
                         id: string;
                         shortRef?: string | null;