propose_write

Propose moving one or more products to a new lifecycle state (e.g. WINNER, DRAFT, CULL). Returns a plan-card the user mu

Changed on

Propose moving one or more products to a new lifecycle state (e.g. WINNER, DRAFT, CULL). Returns a plan-card the user must approve before any change is applied. Never writes to decision_log or Shopify directly.

post/api/v1/tools/propose_state_transition

Request

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

to_state'WINNER' | 'OPTIMIZE' | 'DISCOUNT' | 'DRAFT' | 'CULL' | 'SEASONAL_VAULT' required

Target lifecycle state.

reasonstring required

Human-readable justification for the transition.

Response

Tool result

okboolean required
resultunknown required

Changes

  • 4a749f94b35cRevision changes
    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new app_not_reviewed enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status

    • warning

      added the new unsupported_behavior enum value to the response property for the response status