Update plan name, notes, or status
Unified plan update endpoint supporting all 6 plan types. Accepts any combination of name, notes, and status in a single request. Fields are applied in order: name → notes → status. Status transitions are validated by the per-type state machine — an invalid transition returns HTTP 422. All changes are recorded in the plan audit log.
Authorizations
User session token issued by NextAuth. For human users accessing Solya via the web application.
Path Parameters
Plan type. One of: RESTOCK, REBALANCE, MARKDOWN, SUPPLIER_RETURN, SUPPLIER_EXCHANGE, PRE_SEASON. Case-insensitive — "restock" and "RESTOCK" are both accepted.
RESTOCK, REBALANCE, MARKDOWN, SUPPLIER_RETURN, SUPPLIER_EXCHANGE, PRE_SEASON Unique identifier of the plan (UUID)
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Body
New display name for the plan (1–255 characters)
1 - 255Long-form notes attached to the plan header. Pass null to clear existing notes.
10000Human-readable reason for this change; written to the audit log
500Target status to transition the plan to. Must be a valid next-state per the plan type's state machine.
1