propose_write

Build an approval card to import product costs from a staged sheet. Call inspect_cost_import first: if it returned ready

Build an approval card to import product costs from a staged sheet. Call inspect_cost_import first: if it returned ready_to_propose=true, call this with ONLY import_id — the mapping is already settled and passing columns can only make it worse. Otherwise pass just the answers to the questions inspect_cost_import listed (identifier_column, cost_column and/or currency). Returns a preview card the user approves; nothing is written until they do.

post/api/v1/tools/propose_cost_import

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/propose_cost_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
identifier_columnstring

Only when inspect_cost_import asked which column identifies the product.

cost_columnstring

Only when inspect_cost_import asked which column holds the unit cost.

currencystring

Only when inspect_cost_import asked. Pass the chosen option's value VERBATIM — either an ISO 4217 code, or the "convert:<ISO>" form, which converts the sheet's stated currency into <ISO> at the platform rate.

include_flagged_rowsboolean

Import rows the sheet itself flagged (a note saying CHECK / wrong / verify). Default false — they are left out and counted. Only pass true if the user, having been told what the note says, asks for them.

title_columnstring

Manual override for the product title column.

sku_columnstring

Manual override for the SKU column.

Response

Tool result

okboolean required
resultunknown required

Changes

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