propose_write

Build an approval card for importing a staged expense sheet, after you have CONFIRMED the plan with the user (store mapp

Build an approval card for importing a staged expense sheet, after you have CONFIRMED the plan with the user (store mapping, currency, refund handling). Pass store_map: an object mapping each raw store-column value (lowercased, exactly as inspect_expense_import returned it) to either a store id, the literal "split" (shared cost, split equally across all stores), or "skip" (do not import). Set split_anchor_store_id to one store id when any value is "split". Returns a preview card the user approves; nothing is written until they do. Always call inspect_expense_import first and confirm the mapping before this.

post/api/v1/tools/propose_expense_import

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/propose_expense_import
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: costs:write)

Request body

import_idstring uuid required
store_mapobject required

Lowercased store-column value → store id | "split" | "skip".

split_anchor_store_idstring

Store id the split rows anchor to.

currencystring

ISO 4217, e.g. EUR. Defaults to the sheet/EUR.

default_frequency'one_off' | 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly'

Default frequency for rows (use one_off for a dated ledger).

skip_refundsboolean

Drop negative/refund rows. Default true.

categorizeboolean

Auto-categorize rows. Default true.

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.