propose_write

Propose soft-removing (drafting) one or more products by transitioning them to the DRAFT lifecycle state. Convenience wr

Propose soft-removing (drafting) one or more products by transitioning them to the DRAFT lifecycle state. Convenience wrapper around propose_state_transition for the DRAFT target. Returns a plan-card the user must approve — never executes directly.

post/api/v1/tools/propose_draft

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/propose_draft
  • 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: catalog:write)

Request body

product_idsstring[] required

UUIDs of the products to draft.

reasonstring required

Human-readable reason for drafting these products.

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.