Update Special Order List
PUT/api/admin/portal/special-order-list
Update any of: enabled, spreadsheet_id (id or Sheets URL), range (tab), brand_id, supplier_id (the supplier linked to products created at checkout — and the supplier the cost tab's costs belong to), note, preorder_min_subtotal, cost_range (optional STAFF-ONLY cost tab, e.g. internal: a part # column + a "Supplier cost"/"Cost" column; must differ from range, else 422; null/blank = no cost source), supplier_pricing_tier_id (the supplier pricing tier the cost is written to on a created product; null = the supplier's own default tier). Omitted keys are unchanged. With a cost tab set, checkout gives each product it creates a supplier price = the part's cost (once, at creation); a part with no cost is still created and the order is tagged "Needs supplier cost".
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.