Scan a receipt using the Recite API to extract financial data.

Provide exactly one input: file_path, image_url, image_base64, or raw_text.

Args: file_path: Local path to an image. image_url: Publicly accessible URL (must use https). image_base64: Base64-encoded image data. raw_text: Pre-extracted text. auto_save: Auto-create a transaction if successful. Requires project_id. save_threshold: Confidence threshold for auto-saving. project_id: Project UUID. Required if auto_save is True. status: Target status of the transaction. image_type: MIME type hint for the image. idempotency_key: Key to prevent duplicate processing. metadata: Custom key-value data. ephemeral: Process without saving scan records server-side. Cannot be True if auto_save is True.

Create a transaction in the Recite API.

Required fields: date: Transaction date (YYYY-MM-DD). amount: Monetary amount (use 'amount', not 'total'). transaction_type: One of Expense, Income, Asset, Liability, Equity. category: Category string. payment_method: Payment method string (e.g. "Credit Card").

Optional fields: vendor, description, project_id, metadata, tags.

Note: The local ledger uses 'total' for the same concept. When moving data from local ledger to API transactions, map 'total' -> 'amount'.

Import multiple transactions at once.

Provide exactly one data source: transactions (list), csv_text, or csv_file_path.

Args: transactions: List of transaction objects to import. csv_text: Raw CSV string content. csv_file_path: Local path to a CSV file. all_or_nothing: If True, fails the entire import if any transaction fails. project_id: Apply all transactions to this project UUID.

Submit multiple receipts for asynchronous batch processing.

Args: items: List of 1-20 task items. Each must provide exactly one of file_path, image_url, or image_base64. auto_save: Auto-create transactions for successful scans. save_threshold: Confidence threshold for auto-saving. project_id: Apply all auto-saved transactions to this project UUID. webhook_url: URL to call when batch completes. webhook_secret: HMAC-SHA256 signature secret for the webhook.

Create a webhook subscription.

Args: url: Webhook endpoint URL. events: List of event types. Valid values: transaction.created, transaction.updated, transaction.deleted, batch.completed. secret: Optional HMAC-SHA256 signing secret.

Create an automation rule.

Args: rule_type: One of: vendor_category, default_project, processing_preference. condition: Condition object (e.g. {"vendor": "Starbucks"}). action: Action object (e.g. {"set_category": "Coffee"}). priority: Optional priority integer (higher = first).

Partially update a rule. The rule_type cannot be changed.

Args: rule_id: UUID of the rule to update. changes: Fields to update. All are optional: active (bool), priority (int), condition (object, simple rules), action (object, simple rules), conditions (array, transaction_rule), actions (array, transaction_rule), condition_operator ("AND" or "OR", transaction_rule).

List all categories: default (17 built-in) and custom user-added ones.

Add a custom category. Duplicates (case-insensitive) are rejected. Max 100 custom categories.

Args: name: Category name to add.

Remove a custom category by name. Default categories cannot be deleted.

Args: name: Exact category name to remove (unencoded).

List all custom vendors for the authenticated user.

Add a custom vendor. Duplicates (case-insensitive) are rejected. Max 500 vendors.

Args: name: Vendor name to add.

Remove a custom vendor by name.

Args: name: Exact vendor name to remove (unencoded).