> ## Documentation Index > Fetch the complete documentation index at: https://docs.layerfi.com/llms.txt > Use this file to discover all available pages before exploring further. # Update custom account transaction > Update a transaction on a custom account. To manage receipts, use the recorded-transaction PATCH endpoint. ## OpenAPI ````yaml patch /v1/businesses/{businessId}/custom-accounts/{customAccountId}/transactions/{transactionId} openapi: 3.0.1 info: title: API version: latest servers: [] security: - BearerAuth: [] tags: [] externalDocs: url: / paths: /v1/businesses/{businessId}/custom-accounts/{customAccountId}/transactions/{transactionId}: patch: tags: [] summary: Update custom account transaction description: >- Update a transaction on a custom account. To manage receipts, use the recorded-transaction PATCH endpoint. operationId: business.custom-accounts.transactions.transaction.patch parameters: - name: businessId in: path description: The UUID of the business. required: true schema: type: string format: uuid - name: customAccountId in: path description: The UUID of the custom account containing the transaction. required: true schema: type: string format: uuid - name: transactionId in: path description: The UUID of the transaction to update. required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object minProperties: 1 properties: amount: type: integer format: int64 description: Transaction amount in cents. direction: $ref: '#/components/schemas/BankTransactionDirection' date: type: string description: Transaction date as YYYY-MM-DD or an ISO 8601 timestamp. description: type: string merchant_name: type: string nullable: true memo: type: string nullable: true metadata: $ref: '#/components/schemas/PlatformDefinedJson' reference_number: type: string nullable: true customer_id: type: string format: uuid nullable: true customer_external_id: type: string nullable: true vendor_id: type: string format: uuid nullable: true vendor_external_id: type: string nullable: true categorization: $ref: '#/components/schemas/Category' responses: '200': description: Updated transaction. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/ApiBankTransactionDataOnly' required: - data '400': description: Invalid transaction update. content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: Business, custom account, or transaction not found. content: application/json: schema: $ref: '#/components/schemas/ApiError' deprecated: false components: schemas: BankTransactionDirection: type: string enum: - CREDIT - DEBIT example: DEBIT PlatformDefinedJson: type: object description: Arbitrary JSON data defined by the caller, with a 1KB size constraint. additionalProperties: true example: custom_field: value any valid json: below 1kb nested: meaning of life: 42 array: [] Category: type: object description: Single-category categorization payload. required: - type - category properties: type: type: string enum: - Category description: Discriminator for a single-category payload. category: $ref: '#/components/schemas/BankTransactionClassification' description: >- A single-category classification to apply to the full transaction amount. tax_code: type: string nullable: true description: >- Tax code to apply to the categorization. Currently only supported for businesses incorporated in Canada (`country` is `CA`) and cannot be used with an `Exclusion` category. Use a `code` from `tax_options` on the [Bank Transaction](/api-reference/bank-transaction/bank-transaction) object that is valid for the transaction's date. example: GST_PST_BC ApiBankTransactionDataOnly: type: object properties: id: type: string format: uuid description: Unique identifier of the bank transaction. business_id: type: string format: uuid description: >- Unique identifier of the business the bank transaction is associated with. source: $ref: '#/components/schemas/TransactionSource' description: Source of the transaction. source_transaction_id: type: string description: >- External transaction ID from the source platform (e.g, Plaid transaction ID). example: g4DlKyjXqGH3Kp5XlaWMtwLRrE4Z9AiE8B4Ko source_account_id: type: string description: >- External account ID from the source platform (e.g, Plaid account ID). example: Aaoy8G7VXZHVeqNoL1GvcmkPdqpLRWi9NArdG external_account_id: type: string format: uuid description: >- Layer's internal UUID for the linked external account. This is distinct from source_account_id, which is the provider's identifier (e.g., Plaid or Stripe account ID). imported_at: type: string format: date-time description: Timestamp when the transaction was imported. date: type: string format: date-time description: Date of the transaction. direction: $ref: '#/components/schemas/BankTransactionDirection' description: Direction of the transaction. amount: type: integer format: int64 description: Transaction amount in cents. counterparty_name: type: string nullable: true description: Name of the transaction counterparty. example: WeWork description: type: string nullable: true description: Description of the transaction. example: WeWork monthly rent payment account_name: type: string nullable: true description: Name of the bank account. example: Plaid Checking categorizationStatus: $ref: '#/components/schemas/CategorizationStatus' description: The status of the transaction’s categorization in Layer’s systems. memo: type: string nullable: true description: >- Memo for any text you would like to associate with the bank transaction (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the bank transaction. Can be used to filter when listing bank transactions. ApiError: type: object description: An error object returned in API error responses. properties: type: $ref: '#/components/schemas/ApiErrorType' description: >- A fixed category for the error, helpful for categorizing and processing errors. description: type: string description: A human-readable error description. error_enum: $ref: '#/components/schemas/ApiEnumErrorType' description: >- A stable, machine-readable identifier for programmatically handling specific error conditions. Only present for 4xx client errors—not included for 5xx server errors. Use this instead of parsing the description field, as enum values remain stable across API versions. nullable: true meta: type: object description: Optional additional information about the error. nullable: true required: - type - description BankTransactionClassification: discriminator: propertyName: type mapping: AccountId: $ref: '#/components/schemas/AccountId' StableName: $ref: '#/components/schemas/AccountStableName' Exclusion: $ref: '#/components/schemas/Exclusion' oneOf: - $ref: '#/components/schemas/AccountId' title: Account ID - $ref: '#/components/schemas/AccountStableName' title: Account Stable Name - $ref: '#/components/schemas/Exclusion' title: Exclusion TransactionSource: type: string enum: - UNIT - PLAID - API - STRIPE - CUSTOM example: PLAID CategorizationStatus: type: string enum: - PENDING - READY_FOR_INPUT - CATEGORIZED - SPLIT - LAYER_REVIEW - JOURNALING - MATCHED example: CATEGORIZED ApiErrorType: type: string enum: - ResourceArchived - AuthFailure - Plaid - Stripe - InvalidState - ResourceNotFound - InvalidParameters - JsonSerialization - Unknown - BadRequest - PaginationCursor - Conflict - LedgerOperationFailed example: InvalidParameters ApiEnumErrorType: type: string description: >- Stable enum values for programmatic error handling. Only present in 4xx error responses. enum: - AccessCodeInvalid - BalanceSheetDoesNotBalance - BalanceSheetMissingAccount - BankStatementParserError - BillStateError - BulkCategorizeFailure - BulkMatchFailure - BusinessTaskAlreadyCompleted - BusinessTaskDeleted - CalendlyOAuthError - CallBookingError - CantUpdateTransactionInCustomerPayout - CantUpdateTransactionInVendorPayout - CheckPayrollConfigNotFound - CheckPayrollServiceNotFound - ClerkUserAlreadyExists - ConflictingQueryParams - CustomAccountAlreadyExists - CustomTransactionCsvParsingError - CustomTransactionUploadFailure - CustomerPayoutInputFormatError - DoesNotMatchExistingEntity - EmptyBatchRequest - ExpenseParserError - ExternalAccountBalanceReconciliationError - ExternalIdConflict - InvalidCategory - InvalidEffectiveDate - InvalidLedgerOperation - InvalidMonthlyAverageRange - InvalidMultiPartRequest - InvalidPaginationCursor - InvalidPayload - InvoiceDeleted - InvoiceNotFound - InvoiceReferenceMismatch - InvoiceStateError - ManualRateLimit - MultipleTagKeyFiltersUnsupported - NoCognitoUserFound - NoOpeningBalanceFound - NotYetReconciled - OnePasswordApiError - OnePasswordItemNotFound - OnePasswordVaultNotFound - OpenAICategorizationError - PaymentLinkInvalid - PayrollStateError - PeriodIsClosed - PeriodNotClosed - PhoneNumberAlreadyRegistered - PlaidApiError - PlaidConnectionBroken - PlaidCreateLinkTokenError - PlaidCredentialsNotConfigured - PlaidExchangePublicTokenError - PlaidGetInstitutionByIdError - PlaidGetItemError - PlaidInvalidEnvironment - PlaidItemAlreadyExists - PlaidItemNotFound - PlaidProcessorApiError - PlaidUnlinkItemError - QueryParamFormat - QueryParamMissing - QuickbooksBrokenConnection - QuickbooksConnectionAlreadyExists - QuickbooksConnectionAlreadySyncing - QuickbooksConnectionMissing - QuickbooksConnectionNotActivated - QuickbooksInvalidRequest - QuickbooksInvalidState - QuickbooksNoMatchingAccount - QuickbooksNonPostingAccountType - QuickbooksNotConfigured - QuickbooksOAuthCallbackInvalid - QuickbooksOAuthError - QuickbooksTokenExpired - ReadOnlyBusiness - ResourceArchived - ScheduleCNotConfigured - SmsNotEnabled - SpecifiedBadRequest - SpecifiedIdNotFound - SplitTransactionError - StepEvaluationBadRequest - StripeConnectAccountIdNotFound - StripeCredentialsNotConfigured - StripeGetBalanceForConnectAccountFailure - StripeRedirectOrRefreshUrlNotConfigured - TagFilterNotFound - UnexpectedQueryParam - UnitAccountsInUse - WrongAnswerType example: InvalidPayload AccountId: type: object required: - type - id properties: type: type: string enum: - AccountId description: Resource type. Value will be `AccountId`. example: AccountId id: type: string format: uuid description: ID of the account. AccountStableName: type: object required: - type - stable_name properties: type: type: string enum: - StableName description: Resource type. Value will be `StableName`. example: StableName stable_name: type: string example: CURRENT_ASSETS description: Stable name of the account. Exclusion: type: object properties: type: type: string enum: - Exclusion description: Resource type. Value will be `Exclusion`. exclusion_type: $ref: '#/components/schemas/ExclusionType' required: - type - exclusion_type ExclusionType: type: string description: Type of exclusion for a bank transaction. enum: - PERSONAL_EXPENSES - PERSONAL_INFLOWS - DUPLICATE_TRANSACTION - OTHER_EXCLUSION x-displayStrings: PERSONAL_EXPENSES: Personal transactions PERSONAL_INFLOWS: Personal income sources DUPLICATE_TRANSACTION: Duplicate transaction OTHER_EXCLUSION: Other exclusion example: PERSONAL_EXPENSES securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ````